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“Without u douht^ the Premiere Resource Editor 
for the Mac OS A wealth of time-saving tooln.^ 

" MacUser Magazine Eddy Awards 

distinct impmmment over Apple's ResEditf 
- MacTech Magazine 

‘^Every Mac OS developer should own a copy of Resorcerer. 

- I^onard Rosenthol, Aladdin Systems 

"Without Resorcerer^ our localization efforts would look like a 
Tower of BabeL Don't do product without it^ 

— Greg Galanos, CEO and President, Melrowerks 


''Resorcerer's data template system Lh amazing."* 

- Bill Goodman, author of Smaller Installer and Compact Pro 

"Resorcerer Rocks! Buy it, you will NOT regret it ." 

- Joe Zobkiw, author of A Fragment of Your Imagination 

"Resorcerer will pay for itself many times over in saved time and effort.*' 

- MacU.ser review 

"The template that disassembles 'PICTs is awesome!" 

- Bill Steinberg, author of Pyro! and PBTHyls 

"Resorcerer proved indispensible in its own creatkmr 
-Doug McKenna, author of Resorcerer 






Version 2.0 


The Resource Editor for the Mac'^^ OS Wizard 


ORDERING INFO 


Requires System 7.0 or greater, 
1.5MB RAM, CD-ROM 

Standard price: $266 (decimal) 
Website price: $128 - $256 
(Educational, quantity, or 
other discounts available) 

Includes: Electronic documentation 
60-day Money-Back (luarantee 
Domestic standard shipping 

Payment: Check, PC's, or Visa/MC 
Taxes: Colorado customers only 

Extras (call, fax,, or email usj: 

COD, FedEx, UPS Blue/lied, 
International Shipping 

MATHEIVLESTHETICS, INC. 

PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440-0707 
Fax: (303) 440^0504 
resorcerer@mathemacsthetics.com 


• Very fast, HFS browser for viewing file tree of all volumes 

• Extensibility for new Resorcerer Apprentices (CFM plug-ins) 

• New AppleScript Dictionary (‘aete’) Apprentice Editor 

• MacOS 8 Appearance Manager-sawy Control Editor 

• PawerPlant text traits and menu command support 

• Complete AIFF sound file disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• Auto-backup during file saves; folder attribute editing 
■ Ships with PowerPC native, fat, and (i8K versions 


• Fully supported; it's easier, faster, and more productive than ResEdit 

• Safer memory-based, not disk-file-based, design and operation 

■ All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulating, editable scrap 

• Searches and opens/marks/selects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource files from simple Rez-like scripts 

• Most editors DcRez directly to the clipboard 

• All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bit List Mgr can open and edit very large data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Balloons, AppleEvent, GX, etc, 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, *ictb’s, lists and popups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Relied on by thousands of Macintosh developers around the world 


lb order by credit card, or to get the latest news, bug fixes, updates, and apprentices, visit our website*** 

www.mathemaesthetics.com 
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hy Neil Ticktin 


Ji'.s ih'Ai time again when 1 want to touch base wiiJi you^ the 
reader, u> lei you know what’s going on in MacTcch land. 

Kditorial Changes 

Yon may have noted th:it weVe added to our ediltmal .staff that 
creates the magazine. Erie Gimdnim, our Fanner Editor-In-Chief, Ls 
moving to the position of Editor Erneritu.s. And, c>ur fbnner Online 
Editor, Nick DeMello, is moving inttj die Fxlitor rt)le. Hinaliy, 
.supporting the online community is JefFrey elites — wlur is new to 
the MacTech staff, MacTech is now providing a variety of services 
in a variety of formats — prinh e-mail, web, in Japanese, and CD, 
Our new staff line up will help us accomplish even moie. 

As pan of our new model, the View|X)int page, which was 
previously almo.sL always wriiien by the tditor-in-Chief, will now be 
a restating column. Well Ix" kxjking to our Editorial Ekrard, and the 
communiiy, for well thought out, timely and apfsnjpriate pitx:es. 
ThLs will give ytxi, the neiider, the fxnefil of many jxrinLs of view. 

Finally, we’re rearranging our Editorial Board, Contributing 
Editors, and I'echnical Editors to engage even more people, more 
often. And, as you see from the letter from Ap[ile (in this issue) 
we’re working wills Apple and Apple empk>yees to bring more 
Apple created content into the body of Macl'ech, All of this will 
help to create a broader s[xxtrum of develcsper articles in a high 
quality kind t>f way. 


MacTech Grows 

Many developers have been very concerned atxjui the Mac. 
We UK) are paying close attention. What weVe found is gocxl 
news. We’ve always found the developer community to be a 
solid indicator of the future. And, in the last 12-18 months, we've 
seen MacTec:h readership gmwe loday, MacTech and MacTech 
japan have evolved into the primary news and information 
vehicle for over 40,000 Mac programmers and tlevelopers in 
about 65 coumries. Tlie magazine lias csuiblished an eminent 
reputation witfiin the Macintosh developer community. 

Fuithconore, as well talk more about next month, it looks 
like the Mac community is at die end of its ".shake down*" cycle 
— more and more developers are repoHing real successes on the 
Mac. All of this bodes well for you, the Mac developer. 

We wish you the best of luck in 1998 and we’re looking to 
see the community succeed more and more . H 
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by Eric Gimdrum 


The Feel of Macworld Expo 

Once iinother Macworld Expo is behind us. As widi p;Lst 
pjcpos, this one had its own, unique feel Thene were noticcalite 
holes where vendors seemed to have pulled out at the last minute, 
and tlie show was ntXiceahly smaller than past years (niosLly due 
to vacancies cTealed hy the clone vendors going away). Even so» 
end users visiting the show were as excited a,s ever. End users who 
liaven't been spending much money on their Macs in recent years 
are doing so now. tt seems as if die t'hanges Mac OS 8 hits brought 
us has revitalized user’s atdaides towards their Macs, 

S<jinetimes we developers forget the excitement we had when 
we first began attending Macworld Expo. 1 rememlier my 
incredible diirst to learn everydting I coukl a!x>ut the pnxlucis 
available for the litde computer knt)wn as Macintosh, Over the 
years, Eve Ix'gun to feel like there is nothing new to .‘a?e. Macworld 
Expo was becoming a drag. A few^ years ago tliis feeling was 
alleviated by ihe Expo Greenhouse. This was a collecdon of a few 
dozen small lxx)tlis fiacked very tightly in a small space; first time 
cxliibiiors were able to show their produas Rjr a tenth llie cost of 
even die smallest regular lxx>di. (Stations w'ere sul>sidized by 
volunteers, sponsors and Expo managemtmt.) The Greenhouse 
was where the new- prcxlncts w'ere sliown; the Greenhouse was 
where all the ccjol products were shown. Unfortunately, there was 
no Greenhouse at January's Exfxj, and I missed it very much. 

Although the Greenhouse was missing, there were stQl plenty 
of ccx)l prcxlucts ai the show, Ihey just tcK)k more work to fmd. 
Having some of the bigger vendors not at the show made it diat 
much easier, because the ,smaiier ones weren't being 
overshadowed so myc:h. A bit of this is hapyxming iti our industry, 
Uk>. Some of the laiger Mac software [Publishers seem to be 
turning their attention to other markets, saying die Mac: market 
now is texp small for them. However, their inattention to dieir 
many loyal users wlio helped them grow their companies so laige 
is opening new opportunities for upsratt rtew' developers. 

Tile main reason I go to Macworld Expo is to meet ]xx)ple. 
the years I’ve developed strong friendships witli many 
developers around die world. 'Ibe Sao iTancisco Expo is one of four 
annual events where I ha\^e a chance to see old friends in person, 
('Ihe others are MacHack, WWIK and the !k).ston Ex}xp, new die 
New York Expo.) I cmjoy the personal contact cjn ihe show llcK>r and 
at parlies widi the people I spend so much time exchanging mail. 
As a devclcjfxjr. I'm lucky dxit I Irnve these four events. Most end 
users have only one: the Mac'world Exjxj closest to them. 

For end users, Ex[Po represents a chance to see and compare 
all the IcxjIs in one place. As an end user, 1 was out shopping for 
a new video card. Expo was aix>ui the only place where I ccjuIcI 
c'ompare cards from different vendors side by side, and 1 could 
discuss how well the differenl ords performed with those who 
know tliem best: the game devckjpers. For end users, the show' 



is a great chance to see aU the tool.s in one place and meet dicir 
creators, for vendors it is a chance to sell interesting new 
products to a very hungry' market, and for developers it's another 
chant:e to catch up w ith old friends. 

Another tidbit IVe i>een hearing recently is that Mac 
software publishers who are developing Windows ports are 
deciding that good Windows programmers are tcK> hard to find. 
They seem to tliink that training a good Macintosh programmer 
how to write gocxl code for Windtws is a lot easier than Iraming 
a dime-a-dozen Windows programmer how to write good code. 

r CAR see the logic of this: Macintosh programmers are 
Madnuxsh users first, and programmers second. As users, we 
understand liow- fmstrating it is to use a poorly designed 
appliaition. Consequently, we spend a lot of energy figuring out 
tJic t)esi user experience jx)s,sil>le, and we spend nine exploring 
our ideas and opinions alxrul user expcmence with other users 
and programmers. In short, we care alx)ut our users because we 
know how they feel alxnit using their computer. The result \s that 
we generally build softw’are that Ls easier to use. Hopefully 
someday the users of Wintel nmcliines will notice how much 
harder they have to work to get things done wilhout a Macintosh, 

What's Happening with RhapsrKiy 

We stiH are a bit too early to lx: seeing Rhapsody software at 
Expo, As far as 1 c'ould tell them weren't any mitinstream 
Macintosh softwaro pul^lishers showing or even talking alx>ut 
RJiapsmly versions of their pnxlucts. Tlie mexst 1 saw' of Rhapsody 
w'as in Apple’s pavilion and the Rhapsody developer \ools in 
Developer CentniL Yet, many of the main,stream Macintosh 
st>flware publishers are advcrti.sing for tdiapsody engineers. 

Afiple has been noticeably quiet alxnil Rhapsody in recent 
months, Tliey seem to have learned alx>ui the dangers of over¬ 
hyping new technok^gies before they are shipping. Mac OS S is 
still going strong, and many Macintosh sottw'are publishers are 
Ixiving great success riding tlie sales wave. No one wants to rock 
the boat with premature talk of Ithap-sody, This is all very good. 

Nonetheless, Apple is .still working very liard on 
Rhapsody, At least, they were in January. Many people have 
told me most Mac OS applicaiions run in the Blue Box (Mac 
OS compatibility layer) wiihtnir any problems. Apple may 
have us on the road to a transition to Rhapsody as smooth as 
was the transition to Pow'erPC. 

Khapsexiy represents some very nice technologies long 
needed on the Mac, inclLiding protected memory, more fx)werful 
system APIs and better development rcKiis, Soon Apple should 
be releasing die Premiere version of rite new OS for end users. 
That will be the first Hue Lest of user's interest in Rliapsody, and 
it will be an opportunity for Afiple to learn more about wlial 
features aro important to users, and what features are not. B 
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hy Dave Mark 


On the Menu for Today... 


How the Macintosh Menu Manager Works 


In last month's column, we expandetl our evenldiandling 
repertoire to inciiidc aaivate, iipdiile, and suspenti/resume 
events. Ry now, you should teel pretty comfonable w\lh the 
Kvenl Manager. If you haven't already, put down this column and 
go read the Kveni Manager chapters in Inside Macintfxsh: 
Macintosh Tch)IIk>x Essentials. 

In this iiKinclVs column, weVe going to take a lc}ok at the 
Menu Manager, the part of the Tck>11>ox ri^sponsible for your 
program's menus. 


selection of the equivalenced menu item, for example, in the 
menu in Figure 1, the command-key etjuivalent W v^all cause 
the Close Window item to l>e selected IVcnn tite RIe mentL 

Items may be dimmed, or disabled, which prevenLs the user 
from selecting them, ff an item is disal^led, it is drawn in gray. A 
nomial item is s;iid lo [jc enabled. 

You may have naiced that .some menu items are drawn 
followed by an ellipsis, a seciuence of three dots (...). The ellipsis 
id Is llie user that this ilem will cause a dialog box to appear, 
prompting the user fur further information. Well get to dialog 
lx>xes in a later column. 


Thf Pull-Down Menu 

Almost every single Macintosh program comes complete 
with its own menu bar, the strip trf menu titles along the top of 
your Mat:'s main screen, 'fhe menu bar contains one menu title 
for each of your program's current pull tkwn menus. Figure 1 
shows the Finders menu bar with the Rle menu pulled down. 


Menu Titles] 


1 I 


I Menu Ber 


iTdit Uiem Lot^r* S|iec;lsi 


I Henu Item } 


New Folder 

36N 



Print 

#P 

Close lllindouf 

mm 

bet Info 

m 



Pupltt^le 

m 

Hoke ftMas 


Put 


-rtno... 

Mf 

Find Bgain 

sec 

Page Setup 

/ 

Print tlimdow. 


d Cpmfnand Key Equiuelent | 


- | Oimmed Menu Item | 


^ Ellipsis I 


Figure t A menu fmr with i4 pull-doum menu exposed^ 


A pn>|>tT menu bar alw^ays features at least three ineiKis, 
Rle, and Edit. When a menu is pulled-down, It.s menu items will 
be drawn, fn addition to the item’s name, a menu item may 
feature art icon, as well as a command-key equivalent. The 
command-key equivalent, witen typed by the user, simulate.s the 


Working; With the Menu Manager 

The Menu Manager con.sLsts of a series of routines designed 
to w'ork with two resource types. MBAR and MENU. The MBAR 
rest>urce links together a scries of MENU resources ttj form a 
menu bar. A MENU resource is used to ctanpletely specify a 
menu, including all the menus items and any asstK:iaied icoas 
and c<mimand-key eqiiivalenus, Here's a quick miir tlinxigh the 
main Menu Manager routines. 

Once you've built your MBAR and MENU resources (ytufll see 
how in a l>it), you're ready to start [)rogjamming. You'll start ofF by 
creating a menu initial i/^ition RTutine. In it, you 11 tall GetNewMBar(), 
which builds a menu list, based f»n the MENUs specified in an 
MBAR resource. A menu list is the data structure the Menu Maimger 
bases a menu Irar on. Once die menu list is built, pass it to 
SelMertuBarO to make it the current menu fvar. Note that you c^an 
have more than one menu bar, bLit only one current menu trar. 

Once you've s[>ecifiecl a current menu bar, draw the menu 
Uir by calling DrawMenuBar(). Now you’re ready to work with 
your individual menus. 

MooiFYiNt; iiiE Menit Bar 

Tltere will be times w^hen the menu Ixtr described in your 
MBAR resoiiau won’t l>e enough. For example, you might Itave a 
menu that appears only if the user kts color turned on, or when 
a t'enain type of window i.s o[xm. You can add a menu to or delete 
a menu from die menu bar. To atld a menu to the menu har^ i:all 
GetMenu(} to load a new MENU rc‘st>uix:e into memory, into the list 
of available menus (but not into the current menu bar). GetMenu() 
reiuras a MenuHandle which you mn pa.ss to lnserlMenu(}. 
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tnsertMenuO inserts the speciitecl menu into the airrent menu bar. 
To delete a menu from tlie menu bar, call DeleteMenuO- 

Another routine you might find useful is GetMenuHandle(), 
which returns a MenuHandie to a menu already loaded into 
memory. Basically, you’ll use GetMenufi to get a handle to a menu 
dial’s never been loaded, and GetMenuHandled to get a handle to 
a previously loaded menu. Use !nsertMenu() to add a loaded menu 
into the current menu bar. Remenilxrr, wlienever you change the 
menu bar, call DrawMenuBarO to bring your changes to life. You 
only need to call DrawMenuBar() when you change die current 
menu bar, not when you change a menu's items. 

Changing a Menu Item’s Appearance 
Tile Menu Manager gives you a set of routines you can use to 
aistomize your menus. For example, die routines EnableltemO and 
DIsableltemO allow you to enable or disable a mernu item. You can 
use the routine AppendResMenuO to add all the R^iuices of a 
specific type as menu iteins. Them axe two specific times wlien this 
rnrnes in handy. To add all the fonLs to a menu, pass TONT to 
AppGndResMenu(). To add all the standard apple menu items to the 
apple menu, pass DHVK' to AppendRGsMenufi, Why 'DEVK? Prior to 
System 7, all die ilenvs in the apple menu were desk accessories, 
which have a resource type of DUVR'. Even dtough System 7 allows 
you to add more diun DA’s to your apple menu, AppendResMenu() 
still works properly, as you’ll see by this month's program. 

You can use SetMenultemTextO to change the mime of a menu 
item. You can use GetMenultemText() to retrieve an item's name. 
CheckItemO lets you place or remove a cheek mark from an item 
and SetltemMarkO lets you placx" or remove any character from the 
system font next to an item, GetltemMark() retrieves an item's mark. 

SetltemlconO and GetltemfconO set and gel the resource ID 
of any icon associated witlt an item. For some rettstin. the 
resource ID returned by Getftemtcon() Is 256 less than liie icon's 
actual resource lU. I'fiis means that your ia>n's resource ID will 
range from 257 to 511. 

SetItemStyleO and GetItemStyleO are used to set and gel ihe 
style of an item's name. Well make use of these funaion's in 
next month's program. 

Detecting a Menu SEiEcrnoN 
lliere are two ways a user can select frt>m a menu. They can 
click the mouse in the menu bar or they can type a command- 
key equivalent. You'll detect a mouse click in the menu bar by 
detecting a mouseDown event that occurred inMenuBar, If this 
happens, you'll c'all a routine called MenuSelect(). MenuSelectO 
tracks your mouse, pulling down menus, highlighting items, and, 
if neemsary, selecting an item from a menu. MenuSelectQ returns 
a value that indicates ihe menu and item that was selected. 

If a keyDown or autoKey event occurs, youH chetrk to see if 
die cornmand-key was down when the event occurred, tf so, 
you'll call a routine trailed MenuKeyO which iranslates the key to 
a value that indicates Uie menu and item llul was selected. 

Wliciher the menu/item was selected via a keyDown or a 
mouseDown in the menu bar, it will lie ti-anslateci into a menu/item 
value. You'll pass this menu/item value on to your own routine 


which proc^ses tlie menu selection. Once you process the menu 
selection, call HiliteMenuQ to uninvert the menu's title, which was left 
inveited by MenuSelectO or Menuf^(), 

MenuMaster 

OK, that's about it for Menu Manager routines. Hiere ate a few 
that we liaven't discussed and you should definitely read the Menu 
Manager chapter In Imide Macintosh: Macinkish Timlbox Bsentiah. 
For now, let’s get into this month's program, MenuMasler. 

Create a folder named McnuMasier in your development 
folder. Now, go into ResFdii and create a new resource file named 
MenuMaster.rsrc in die MenuMaster folder. Select Create New 
Resource from the Resource menu and create a new MBAR 
lesourcc. When the MBAR window appears, dick the row of 
(Figure 2> and lypc^ K to create a new MENU field. When the new 
field appears, type in the MENU id 128. 



Figure 2 Click ibe *'s and type K to add 
a MENU to the MBAR. 


When the second row of appears, dick it and type K to 
create a second MENU field. Repeat this [>rt>cess till your MBAR 
kxiks like the one in Figure 5. 

Close the MBAR window, and close the MBAR picker window. 
Next, selm Create New Resource from the Resource menu and 
creite a MENU lesouroe. When the MENU editing window appears, 
click the mdio button to create an Apple menu. Hit a c’arriage 
return and type in the text About MenuMaster,. followed by another 
c'arriage return. Now' dick the separator-line radio button to insert a 
sef^nitor line after die About MenuMaster.., item. Because .separator 
liiK^s arc never enabled, they'll never Ix^ chosen by tlie aser. Your 
menu should Itxjk like die one shown in Figure 4, 



Figure S Ihefiiled out MBAR resource unth four 
MENU resource ids. 


8 


Gethnc Started 


MAdl'Eui • March 1998 






























The 13^ Annual Conference for 
Leading Edge Developers 

MacHack patters are the cornerstone of the premiere Macintosh teclinical 
conference. Papers cover a wide variety of cool topics. Anything from 
Adaptive Computing, the Btisiness of Macintosh Development, Game Design, 
and Internet programming, to lUiapsody, Debugging, the Programming 
Subculture, Virtual Reality, and Mac OS internals and hacks. 

Would you like to astound and amaze your peers and also get a free conference 
registration? If so, then sham your in-depili knowledge of a lechnkjue, 
tetfmology, pfiilosophical point, or some odier arcane knowledge and WTite a 

pajXT for MacHack ’98’ 

Point your favorite email program to machack-papers®macliackxom and send os your idea, abstract, questions, 
or other secrets. Abstracts are required by February 15, 1998, 

Attendance is limited — register early. 

Bound proceedings Best Hack CD will be distributed to all attendees. 

For more information or to register: 

Kxpotech, 1264 Bedlbrd Kd., Grosse Pointe Park, MI 48230-1116 
313’882-1824, expotech@aoLcom, http://www,machack-com/ 

MfjninJogh a trademark of AppEe Computer Alt others to their respective hotdefs. MacHack is a trademark of Expotech, Inc, Not affiliated with the MacHax Greup'^. 
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Help Make MacTech Work 


E rt: at MacTeeb Magetzim, we vdy heavily 
on outside writers for mast of the miiteriaJ that 
appears in our pages. If readers did not 
participate in tire magazine, sending U5 their 
ideas and taking the time to write articles, 
there would he no MacTeeb. MacTeeb 
Mufiozine is not a staff of writers sending a 
constant si ream of one-way messages 
outwards; iCs a living, evolving network of 
readers conversing with one anotiier, 
educating one another, sharing their 
knowledge, their exf'jerience, their interest, 
their trials and tribulations and joy.s and 
successes in die a instantly unfolding .story <4 
programming the Macintosh. MacTeeb 
Magazine doesn't just happen; it's what the 
communit}^ makes it. If we carry reports of 
future trends and technologies, if we teach 


usekil nx;rhcxLs, if we review new^ txx)ks and 
tools, if we provoke rhoughr, provide help, 
ride The wave of current interests and 
concerns, it is only because we reflect the 
dioughts t>f our readers, who speak through 
our pages. 

You are invited to involve yourself in 
thi.s exciting conversation amongst readers. 
No mauer who you are, no matter what 
your credentials may be, if' you have a tale 
lo leif a trick lo share, a technique to teach, 
we want you lo consider joining the family 
of lhase wlio write for MacTeeb. 

Don't ju.sl wait for a topic to be 
covered nr a technique explained in 
MacTeebt Take re.sponsibiliiy! Write us an 
article your^self! 

To write for MacTeeb, just send for our 


Writer's Kit. It's a Microsoft Word file 
containing the Styles you ncx-d to use, and 
giving lots of hclphii advice and informaLion, 
including all die legal stuif. You can let lis 
know wliai you'll writing alxait, or, if you 
want to, you can just write the article and 
S[>ring Tt on us when frs dune. [Note: We 
also have a need for j>eople willing to make 
themselves available to write occasional 
produo/'book revkw^sj If we publish your 
article, you'll be paid for it! 

Write to us, the edlioriai staff, at 
ediiorial@maciech.com Cor one of the other 
addresses listed on page 2 of die magazine), 
J'ake the future of MacTeeb Magazine into 
your own hands! 
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Options 


MENU 1U = 12S ffom MBnuMBsler.rsrc V/~-L£ir7rr 

□_ 

] tnliri Menu: ^Enabled 

About HenuMa^ter... 

iD* 


; Title; Oil 1 

® # (Apple menu) 

Color 

Title: 

Item Teut Default: 

Menu Beckgroobd: | | 


MENU lU “ 131 from MonuHaslenrsrc I 


Change My Name 


Disoble Me 

£rii!hi^ Pi tt&m 


Hdd EHtra Menu 
Append Menu 


Entire Menu* 


^ Enabled 


Title: ® 

O 6 inpple monul 

Color 
Title: ^ 
llerti Tehl Oefault: ||H|| 
Menu background; □ 


Figure 4. Sl)ecificatmm for MENU 128. 


Figure 1 , S^cifKatiom for MFNU 13 F 


Close the eciiting window and press K to create a new MENU 
resoorce. This time, instead of clicking the radio button, type the 
word RIe in the Tide field and hit a carriage return. Next type the 
w^ord Quit and type the letter Q in the Cmd-Key field diat appears. 
YouVe just made Q a command-key equivalent to the RIe menu’s 
Quit item. Your menu should look like the one shown in Figure 5 


menu IB » 12 !? from MenuMa^ter.rsrc 


Ellel 

Selected Item; Enabled 

Quit M 




Tent: ®|auil| 1 

Q —tieparalur line) 

Color 

|□ha« Submenu Tenl: 

Cmd-key: 

Mar 1 c:| None 


Figure 1 Specificatiom for MENU 129. 

Close the editing window and create another MENU, using 
the MENU shown in Figure 6 as a guide. Be .sure to add the 
separator line after the Undo item, and to type in the four 
command-key equivalents. 



Figure 6. Specificatiom for MENU 130. 


Close the editing window and aeate yet another MENU, 
according to the specificatioas shown in Figure 7. Be sure to 
include the diree separator lines, ff you forget one, you can add 
one at the end of the menu, then click and drag it to its proper 
position. Notice that the item labeled En^le Previous Item has 
been disabled. Do this by making sure die Enabled check box is 
unchecked for that item only. 


Finally, create one more MENU. Use the title Extra Menu and 
add the item Delete This Menu (Figure 8). 


MENU 10 " 132 from MermMottcr.rsrc 


Delete Tills Menu 


Entire Menu: 


lEI Enableil 


Title: ® [EMirg 


O 4 fRpple menu) 


Color 

Tllte: 

I ilem Tenl Defotill: 

\ Menu Bo ck ground: | ] 


Figm^S. Specifications for MENU 132. 

Next, click the item Delete This Menu and select Choose 
Icon... from die MENU menu. You’re going to attach an icon to 
tlie menu item. When the dialog box appears, click the Small 
Icons radio buUon, then click the New button. 


Choose an icon for this menu itein: 



O Normal Icons (ICON) [ Neiu | 

O Reduced Icons (ICON) 

® Small Icons (SICN) [ Edit ] [ OK ] 


Cancel 


Figure 9 . The Chime Icon... dialog box. 


When the SIGN editing window appears, go to town. 
Create whatever kind of small icon your heart desires. Gel 
creative. Figure 10 shows my SIGN, lifted from the Macintosh 
Frogramming Primer. 


10 


Getting Staktes) 


Ma^Tech • March I99S 







































































































H Have you seen this man ? 

Hacker Harry and the pirate gang are 
loose and robbing the software stagecoach. 
Whether it’s software, bank account information, 
money transactions, or customer databases, 
if you want to them and collect your 
part of the reward... the place to find your 
New Generation Protection solution is at: 

WWW,micromacro.com 

The expected losses due to piracy in the software industry alone 
are over $15 billion for 1997. Some of this belongs to YOU. 
By using MicroGuard’s New Generation Copy Protection keys, 
you will enforce your rights and guarantee your profits. 
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Ji SICN ID = 257 from MeouMas 



\r 




Figure 10. A SlCN wtib a resource !D of 257. 

\I you preferred, you could use an ICON or a reduced ICON 
resource inMead Personally, 1 prefer SICNs or none at all. Once 
you are done editing your SICN, close the SICN editing window. 
You can get a preview of the menu by clicking the prototype that 
appears on the right end of the menu bar Your SIGN should he 
in place. If not, be sure your SICN has a resource ID of 257. Icons 
attached to nieiiu items must have an ID between 257 and 51L 

Once you are happy with your MENU, close the MENU 
editing window. You may have noticed that youVe created 
MENUS with resource IDs 128 through 132, while y<mr MBAR 
only includes MENUs with IDs from 128 to 131. Well add tliis 
extra menu to our menu bar from inside our program. 

Well, that’s about it for resources. Quit ResEdit, making sure 
you Save your changes. 

Creating the MenitMaster Project 

launch CfxieWarrior and create a new project based on 
the MacOS:C/C++:Basic Toolbox 68k stationary. Turn off the 
Create Folder check box. Name the project MenuMastermcp 
and place it in your MenuMaster folder Remove SillyBalbx: 
and Silly Balls, rsrc fnjm the prtjject; wc will not be using 
these files. From the Finder, drag and drop your 
MenuMaster. rsrc file into the project window^ You also can 
remove the ANSI Libraries group from (he project, because 
we won't need them, either. 

Select New from the File menu to create a new window. 
Save it under the name MenuMasrer.c, Select Add Window from 
the Project menu to add Menu Mas ter.c to the projecU Your 
project window^ should look something like Figure 11, 
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# 1^ MenuMaster ,rsro 

n/a 

n/a 
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^ Mac Libraries 

0 

0 

• 

0 


¥ MSL Runtime6SKLib 

0 

0 

* 

0 


¥ ^MacOS.lib 

0 

0 

* 

0 


# g Mathtib68K (2i) lib 

0 

0 

4 

0 


5 files 

0 

0 



m 


figure 1h MenuMaster propel windouK 


Rather than print the code here twice, we'll go straight to the 
walk-through. You can type in the code as we discuss it below 
and you will end up with the complete progmm, or you can save 
your fingures some effort and get the complete project fn>m 
MacTech's ftp site <ftp://ftp.maaech.conn/src/>. 

Walking Through the SoitRCE Code 

Much of MenuMaster’s code should be familiar to you. Thai 
being the case, Fm going to breeze over the familiar stuff, 
focusing on the new stuff 

Foi- starters, notice the way the #defines have been set up for 
the menus and menu items, in general, you’ll c'reaie a #define for 
each menu and item, starting the menu #defines witli tlie letter 
Jn' and the item #deflne,s with the letter ‘i’. 

//include (Menus,h> 

//include (Sound.h) 


//define kBaselesID 
/Ideflne kMoveToFrunt 
//define kSleep 

#define kLasLHenu 

//define uiApple 
//define iAbout 

//define mFile 
i/define IQuit 


//define mOptlons kBaseResID+i 

//define iChangeMenve 1 

^define iDisabieHe 3 

i/deflne iEnakleFrev 4 

//define iAddExtraMenu 6 

//define iAppendItem S 

#d(?firie iAddedlLowi 9 


128 

{tfindowPtr)-lL 

7 


kba^eRcsID 

1 

kBaseResIO+i 

1 


{ define kUnchangedName "VpChange Hy Nitine" 
define kChangedName "VpChange Me Back Again” 

{ define mExtraMenu kBaseReaID+4 

define iOeleteMeru I 


The global gItemNameChanged is a Boolean flag, used to tell 
whether the first Options item has been changed or not. 

Boolean gDone: 

Boolean gItoraNaroeCbanged = false; 
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And wc can't foi^ct our function declarations: 

voidToolfioxInitC void ): 
void Mindowlnit ( void )i 
void HenuBarlnit{ void ); 
void EventLoop ( void J: 
voidDoEventi EventRecord 'eventPtr ): 
void Handl 0 MouseDo¥n( EventRecord ‘eventPtr 
void Hand!eKeniiCboioe( long menuChoice ): 
void HandtcAppleCboICO( short item J: 

Void Hand 1 eF11 eCholee ( sho r l item ): 
void HandleGptionsChoicet ijhort item ): 
void HandieExtraMenuChoice( short item ); 


RHAPSODY 

READY 

POWER 


Notice tfiat maln() calls a new routine, MenuBarlnit(), which 
handles the menu initialization. Toolboxlnit{) hasn't cliangeci. 

voidmaltit void ) 

I 

ToolBoxInit0: 

HenitBarlnit (): 

KventhoopO : 

1 


. * . “******^TQolBoxinH 7 

void ToolBoxInit C void ) 

I 

TnttGraff Aqd.thePort )j 
lalLFontsO: 
XnltWindowsO ; 
InltKenusO i 
TEInltO : 

InitDialogst nil ); 
TnitCursor[); 


NOW 


THERE'S 
NO REASOiA 

TO WAIT 1 


ii 

i 

% 






MenuBarInitO loads tlic MBAR resource and makes the 
resulting menu l)ar die current menu bar 

r*"**””’”""*' MenuBarlfiit 

void Met! uB at lax tt void ) 

I 

Handle menoBar i 

HeniiHandle mnnt 

menuBai GciNowHBort 1<BaseResT0 ); 

SetHenuBacE neimBar )i 

Next, AppendResMenuO Ls called to add the apple menu 
items to the menu. Nt>tice diat GetMenuHandle() was used to 
retrieve die menu handle, lx?cause the MENU resource was 
already loaded into memory as part of the MBAR, 

menu - GetMenuHandleC mApple ): 

AppendResHf*nu( manu, 'ORVR^ ]: 


Finally, the menu bar ts drawn with DrawMenuBar(). 

DraTvHaouBatO ; 

I 

We have our standard EventLoopO* 

iTvcntlixjp 

void EvontLoopf void ) 

( 

EventRecord event; 

gDone - false: 

vhtle t gDone “ false ) 
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I 


if ( WaitNextEvent( everyEvent, tevent, kSleep, nil ) ) 
DoEvent( &event )i 

] 

1 


'Ilie next big change is in the DoEvent() code. 

Dolivtni V 

voi4DoEvent{ EventRecord “eventPtr ) 
i 

char theChat; 

switch ( eventFtr->whflt ) 

[ 

case mouseDown; 

Handl 0 MouGeDown( eventPtr )j 
break; 


‘Ihe charCodeMask is used to retrieve the cliaraaer erri^edded 
in the keyDow or autoKey event* If the command-key was held 
dovm, the chaniacT is passed io MenuKeyO which traasbtes it into a 
menu and item code. Tliis code is passed on to HandleMenuChoioe() . 

case keyDown: 
case sutaKey; 

theChar ” eventPtr >iiessage & charCodeHask; 

If { (ev€ntFtr->modifierfl ^ caidKey) t= 0 ) 
BandleMenuChoice( MenuKeyt theChar ) ): 
break; 

) 

1 

HandleMouseDownO also contains a change. 

.HandkMfHLscDown 7 

void HandleMouseDownC EventRecord ^eventPtr ) 

f 

VindowPtc window: 

short thfiPart: 

long menuChoice: 

thePart ^ findVindowt eventPtr->where* ^window ): 

switch ( thePart ) 

I 


ff tlic mouseOown was in the menu bar, the event is passed 
on to MenuSelectO which alst) returns a menu and item code. Tfie 
code is again passed on to HandleMenuCholce(). 

case inKenuBar: 

osnuCholee “ HenuSelect( eventPtr->where ); 

HandleMftnuCholce( menuChoice ); 

break; 

caise inSyaWindpw : 

SystemClickf eventPtr. window ): 
break: 

1 

I 

HandleMenuChoiceO pulls the menu and item out of the 
menu/item c(jde* 

/- HamllcMcnitChoicc ********^/ 

void Hand laMenuCholceC long menuChoice ) 
t 

short menu; 

short item; 

If ( aenuChoice t= 0 ) 

I 

menu - HiMord( menuChoice ): 
item “ LoWordt menuChoice ): 


menu is used to decide wtiich menu handling routine to ttalL 

switch ( menu ) 

\ 

case mApple: 

HandleAppleChoiceC item >; 
break: 
case mFiloi 

HandleFileCholce( item ); 
break; 

case ffiOptions: 

Handle0pt±onsChoice t item ): 
break; 

case mExtraKenu; 

Hand1eExtraMenuCholce{ item ): 
break; 

I 

Once the handling routine returns, Hil(teMenu() is called to 
unhighlight die selected menu. 

HlllteMennC 0 ): 

1 

I 

.HandlcApplrtJhuicc 

void HandleAppleChoice( short Item ) 

1 

HemiHan die a pp 1 eH enu: 

Str253 accName: 

short accNumber; 

switch C item ) 
t 


HandleAppleChoiceO handles the About MenuMaster,.. item by 
beeping once. 

case iAbout: 

SysBeept 20 ); 
break; 

If any other item is selected, OpenOeskAccO is called to 
launch die appropriate item. Under Sy.stc*m 7, the item might not 
lie a de.sk accessory. 

default: 

appleMenu “ GetHenyHandle( mApple J; 

GciMenuItcmTGxt ( apploMoim, iLom, accNatac J; 
accNumbor ^ OpenDGskAcc( accName ); 
break: 

I 

i 

HandlefileChotceO sets gDone to true, which will cause the 
progjuin to exit. 

^***************** iiandleFilcChoicc 

void HandlsFileChoicet short Item ) 

I 

iiwitch { item ) 

( 

case IQuit : 
gDone = true: 
break; 

* 

J 
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HandleOptionsChoiceO takes the appropriafe action, 
dej^ending on the action selected. Notice that GelMenuHandleO is 
used to retrieve the Options menu handle 

iJ;indkOpik>nM3hotcc."7 

void HandlfiOptioEsChoicei short item ) 
t 

HcnuRartdle menu; 

merju ' GetHt;nuiiaiidle ( mOp Lions ) ; 

switch [ item ) 

{ 

case iCh a ngetjam e; 

if ( gTtp.mNameChanged ) 

SetfienuTteifiText [ tnetnn IChangeNaine, kUncbangedWame ); 
else 

SetHenuItemTe3tt( menu, IChaagcName, kChangedName ): 
gltemNameChanged ~ I gXtemNameChanged; 
break: 

case iDiaableKa: 

Diseblett^mf menu, iDisableHe ): 

Enableltem( menu, iEnablGprev ); 
break; 

case i£nable?rev; 

Diaableltemt menu. lEnableFrev ); 

EnableltemC menu, IDisableHe )i 
break; 

cane iAddExtrsMenu; 

DlsablcTterat menu, lAddExtraHemi ); 
menu ^ GetMeuut mExtraHenu ): 

InaertHenuC menu, kLaatHenu 

DrawHenuBarO ; 

break; 

case lAppendltem; 

AppendMenuf menu. "XpCan^t Delete Me...” ): 

Msablcltemt menu, iAppendltem ): 
break: 

case lAddedltem: 

SysBeep( 20 ); 
break: 

I 

I 

Finally, HandleExtraMenuChoiceO handles a single item. 

y«*«rtrtrrt-tTt*4 HandlcExtiuMcnuChoicc ****^/ 
void HandleExtraMenuChoicet short item J 

I 

MenuHandle menu; 

switch ( item } 

( 


When Delete This Menu is selected, the Add Extra Menu item 
is reenabled on the Options menu. 

case iDfileteMenu; 

menu " GetMenuHsndle( mOptions ); 

EnablelLemt menu, iAddExtraMenu ); 


Next, the Extra Menu menu is deleted and the menu bar is 
redrawn, 

DeleteMcnuf mExiraMenu ); 

DravHeuuBarO : 
break: 

I 

I 


lhat's it. Be sure to save the file if you are typing Uiis in. 


Running MENuMAsniR 

Run tlie project by selecting Run from the Project menu. 
When the menu bar appears, select Change My Name from die 
Options menu. If you click on die Options menu again, youll see 
that the item lias Ixicn changed to Change Me Back Again. Select 
tile item again and it will change back to its original name. 

Now select Disable Me from the Options menu. If you click 
on the Options menu again, yoiril see that the item has been 
disabled and the next item, which was disabled, is now enabled. 
Select Enable Previous Item and it will be disabled again, while the 
Disable Me item is reenabled. 

Next, selea Add Extra Menu from the Options menu. A new 
menu will appear in the menu bar, named Extra Menu. Tn 
addition, the Add Extra Menu item is dlsalilcd. If you click Extra 
Menu, you’ll notice diat die SICN appears to the left of the Delete 
This Menu item. Select Delete This Menu and the menu will 
disappear, and Add Extra Menu will he reenabled. 

Next, select Append Item from die Options menu. A new item will 
appear in die Options menu with the nan'ie Can1 Delete Me.... As its 
name impUas, once you've added an item to a menu, you can't 
delete it. If' you select Can't Delete MenuMaster will l>eq> once. 

Final ly, type Q to exit die program. Q is the command-key 
equivalent for the File menu's Quit item, 

Tnj, Next Time 

Well, diat’s alxiut it for this month. Next month, we’ll dig a 
litde further into the Menu Manager. Till then, go read Inside 
Macintoshf and save me a slice of piE7.a... D 


Want to share a tip with the 
community and get paid for it? 
Send it in to 

<mailto:tips@mactech.com> 
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RHAPSODY 


by Karl Kraft 


Rhapsody in Purple 


An overview of the several 
ways to patch applications 
in Rhapsody, with various 
levels of bravery 


usually a single binary iiria^e LhaL coniains execuLuhlc code. 
Under Mac OS, this executable would also have a lesoLirce fork 
with various resources bound to the application. 

tinder Rhapsody, an application coasists of many more 
parts, each of wliich is either executed or interpreted by tlie 
system as a whole. The most basic patts are: 


OVERVUiW 

Rhapsexiy may have an OS 8 look and 
feel, but under the ho<xl it is running a 
completely different engine. While this 
new engine may sweep away some of our 
most beloved Mac items, like loadable 
".sy.stem’' txxle in the form of LNI is and 
CDEVs, their Rhai>sody equivalents are f)y 
no means non-existent, or even difficult to 
implement. In fact modifications to the 
sysiem and to applications under 
Rhapsody can l>e done in a clean and safe 
manner using high level constructs. 

Thi.s article seeks to explain how a 
Rhapsody application comes to have a 
l^aiticular Itxrk and feel, and ultintately how 
to modify' the kx>k and feel of not only your 
applications, but all applications on the 
system. The overall effect of the source in 
the article is to change tlie fbackground color 
of windows to an awful shade of puq^le. 

How PRtMTRAMS Launch in Rhapsody 

When a user thinks of an ap(>lication, 
he usually thinks of a single software 
package, such as ‘^ClarisWorks”, which is 
actually a collection of templates, fonts, 
applications, help files, and other 
miscellaneous items, 

When most developers thinks of an 
application, the target is mc^re specific, 


1. The executable file, which includes loading instaictions for 
individual processor families, and basic information such a,s 
the application's icon. Under Rhapsody, this comes in a 
format called '‘mach-oT 

2. Resources in the form of images, property-lists, string files, 
and others. 

3. NeXT Interface Builder or "nil.T files, that define the layout 
and (‘onnection of objects in the interface. 

A. Various frameworks and dynamic libraries supplied by Apple 
Computer, such as A]>pKil, FoundalicHi and System. 

3. 'I'he Window Server, a separate prcjgram tliat handles all the 
drawing and PostScript imaging. 

6. The many utility and server pn>giams that run on the machine 
such as AKServer (short for AppKit Server), a [)rogram tliat 
helps liandle the pastelx)ard, 

7. The mach kernel and underlying operating system. 

Together these pieces offer you, the Macintosh hacker, 
doj^ens of places where a patch can be applied both for your 
projects, and applications delivered in a compiled form. 

Simple Non-Code Patoies 

Even if you aren't a programmer, you shouldn't have 
much I rouble figuring out how to use interface builder to 
modify an application. Tliis can be useful when a sysadmin 
type desires to remove functionality from an application, or 
perform interface butchery. 

Using Viewer, the Rhapsody equivalent to Finder, seled an 
application such as Tcnninal.app. For Lliis example, pretend that 
you have have been ordered to prevent users from changing 
their preferences in this application. 


Karl Kraft <Kurl_Kraft@ensuing.com> lia.s wrinen several applications for OPENSTFP, the operating .system on which Rhapsexiy 
Ls leased, and is currently working on The CcxIeBfXJk, an interactive Ixjok for learning the Yellow Box framework. 
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With Diamonds 
This Perfect, 
The Only Thing 
We Cut 


Mitsubishi's full fine of award-winning DJAMONDTRON^'^ aperture grille 
monitors have a proven reputation for quality, reliability, and value. And now 
you can get all diis at prices lower than ever before. Mitsubishi 
P lus, you'll have added confidence knowii'ig that all 
Mitsubishi Diamond Plus* and Diamond Pro*" Series 
monitors are backed by a full 3-ycar warranty, combi ned with 
service and sup];xirr programs rhat are already the l>est in the business. With 
the new lower pricing, everyone can experience the D1 AMONDTRONl 
difference. Get all the JotaiU by contacting Mitsubishi Electronics lixlay. 



Mar 





MaNiomiMi 

**** u 


4 

OEST 

BUY 


Are The Prices. 


USA: 1-800-843-251 “j • Canada: 1-800-387-9630* Qwilcfax: 1-800-937-2094 
World Wide Web: 'www.init.subishi-displa'y.coiii 



A MITSUBISHI 

DISPLAY PRODUCTS 


Innovation On Di.s|>lay* 


Diamond Plus' Series 

DfAMONDTRON displays for people who mean business 

QSjSonly $1499 Reduced to $679 Only $599 

Diamond Plus lOOe Diamond Pro 87TXM Diamond Plus 70 

•21719,7“ DVr •17716.0“ DVt* •ir/ 16 . 0 “DVr 

.1600x1200/85 Hz -1600 x 1200/66 Hz ‘1280 x 1024/65 Hz 
•30-108 kHz *30-86 kHz -30-70 kHz 

auto-scan range auto-scan range auto-scan range 
•USB-ready 


Diamond Pro^ Series 

DIAMONDTRON solutions for graphics professw^^ 

tUS^Only $1799 Reduced to $1399 Reduced to $849 

Diamond Pro 1000 Diamond Pro 9tTXM Diamond Pro 700 

•21719.7 DVr .21719,7 DVI* .17716.0“DVr 

.1800x1440/76 Hz -1600x1200/75 42 -1600 x 1200/75 Hz 

•30-115 kHz .30-95 kHz ■ 30-95 kHz 

auto-scan range , auto-scan range auto-scan range 


Minnbtidii Anwntii, lui:. lYAMONIMWON mxltmiwi irf Mtrmhwhi EWrnr Cjrrpiirutiiin, IVm pihI I’lu* .uft 

inkleokurliiMrnutMiJu Uki.tfijMk-- Amrrli*^, Jm*. Mk-tiiwili, Wnnksw* imd i(K' W<iHl;n*n tipi wi? Kgunpml Mlc'riwrrfr Mih HttJ llw 

■{39^ biKivrm' irtttk'inwik^ .4 A}rpk: (. Inc [irH:4-4 .irhl -^rrfvirniina h'E Mtiijumt ucHike- 'I'lVL Vk.wfth1i< Itn-ifto) 











Note^ Defaults tan Ix" changed in ways Ix^sides the 
preferences panel, but the ly|x: of jx.’ople w^ho would try this stunt 
would seldom think out the total impact of tiieir interfat e butchery. 

Stall by making a copy of Terminal.app, and storing it in a 
safe place. You niiglit need it to recover from your aatons. 

Terminal.app Is actually a folder that contain.s the various 
resources and executable piet^es of tlie 'Femiinal at)plic^tion. 
I'hrough die magic of Viewer, folders w^ith the .app extension 
appear as single files. You can invoke stronger magic by selecting 
Teniiinal.af)p, and then picking "Open As Folder” fnjm Viewer's 
File menu, 'lliis should reveal a folder with three items, a file called 
Terminal, which Is the aaual executable image, a folder with a 
header file for communicating with TenninaL and a folder mlled 
Resources. The Resources folder contains aU the resources for die 
application, such as images, nib files, string files, and property lists. 

Dc’seending into the Resourees folder, you .should find a folder 
tilled tnglish.lpn)j. Tlie Iproj extension indicates a language project, 
which cx>ntains all tlic locali/nble items for this application. Tills is 
often just alx>ur every^ resource in tiie application, Even images are 
l(x:alizahic, because the concept they represent can lie t:onveyed 
differently in each language. An image of a dollar sign might lx.‘ 
localized lo a Yen symixd for the Japaneiie language projea. 

Inside English.Iproj you strike paydirt, a nib file that is 
cleverly naineci Terminal.nib, You can open thi.s nib file in 
interface builder by double t'licking on the nib fde icon. 

Note: Terminalapp and all tlie rcMiurces grouped with it are 
not mixlifiahle by a regular itscr. You need to lie either logged in as 
nxH, or working on a copy of 'rerininal.app that liclongs to you. 

Using Inierfacc Builder, you can navigale thixiugh iJic 
Terminal menu stnicture until you find the Preferences menu item 
Since nib files contain not only interface ohjetis but also theii* 
connections, you on discover what metlicxl Ls callcxl when this 
menu item Ls clicked. Using the Inspector, and selecting 
connections, you should discover that it is connected to the File's 
Owner object, and calls the methtxl preferences:. 

Simply picking disconnect from the connectitins inspeaor 
will render this item impellent, leaving a boring menu item that 
does nothing. Perhaps a dash of purple will help spice up things 
, Using Tnierfhce Builder, you can add a panel lo the application, 
with some nice purple text, that says “'lliis item is disabled”. You 
can .see a sample of my panel in Figure 1. 

preferences 

This menu 
disah^ " 


Figure L 


Hold down the control key, and drag a line from the 
Preferences menu item to the title bar of the newly created panel, 
and the connection inspedor will appear, ^et the connection to 
ma keKey AndOrd erFi ont:. 

Now' save all your mischief and give it a try. If yf)u did it 
riglit, picking Preferences .should bring up your new preferences 
panel, and frighten the user from every picking an urn 
auihorized menu hem again. 

You am edit jiH alxjut any resouice in tliis manner. Images, 
pn)[DetTy lists, and othcT resources can lie mtxiified Ixy simply using 
tiie appnipriate editor. You cm also use dhs teclinkjue lo I(x:^ili7e an 
application timt has not Ix^n localized to a desired language l)y the 
developer. Simply copy English.Iproj to Esperanto.lproj, and edit 
away. 1lie changes you make in Rspemnto.Ipnjj will Ix^ seen any 
user whose default language choic'e Is set to Esjx^ianto Ixfore English. 

CotOH Me Purple All Ovtr 

What if you desire a more drastic cliange? What if you want 
all the windows in your application to have a puq)le background? 
One option would lx lo carefully check every time a window is 
created, and set its l?ackground color lo purple. 

In a small application that might work. A few window.^ 
means a few lines of code. However, I know of several 
OPENJi'FEP applieatioas that have on the order of several 
hundred nib files, and hundreds of window.s iliai t^an be created 
on the fly. Such a manual technique would lx troulilesome, 
because yt>u would eventually miss a window, and iLs gray 
background would jusl look atrocious compared to all the 
gloritxis purple window's spread across the screen. 

Tlieiie is a better way, and in this example, you will convert 
TextEdit to pixxiucc* purple panels and w'indow's. While you read 
this next section, grab a copy of the souree to TextEdit from 
/NeKtDeveloper/Exampies/AppKii/ fn>m tlie Rhapstxly Developer 
Rcicxisc, and start the project building. 

One of tile great advantages of Objective-C is the ability to 
completely override a class by a technique known as posing. In 
posing, a class (ie: PurpleWindow) a,s,sumes the identity of its 
superda.Hs, such as NSWindow. In Figure 2 a simple class tree 
shows w^here NSPanei and PurpleWindow are lx?th sulxlasses of 
NSWindow. After PurpleWindow Ix^gins posing as NSWindow, 
die class free is changed to that of Figure 3. 


I 

I 
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Fif>ure 3* 

By using this technique, you can not only suixfass an 
existing class, l>ut iriiike the implementation of your class the 
default impleinemation for tlie super ckis,s and all it’s sulxiasses. 
This saves you from the troul)le and difficulty of having to write 
a sepaote subclas^s for NSWindow, NSFanel, and otlier windows 
that you may at>L even know exist, 

To see tills in aaion, use ProjectBuilder to cieate a new class 
called PurpleWindow, ProjectBuilder w'ill create two fdes for you, an 
,ni fiJe (methods) and an .h file (headers). A quick kxik at the 
header shows liiat ProjectBuilder thinks PurpicTOndow is a subclass 
of NSObject rather than NSWinclow. Edit tlie header file to read: 

#impo r L < Ap pK 11 /AppKit * h > 

impLa 1 ion PiirpleWindow: NSWindow 

fend 

Now the question is, how do you get Purple Windows to Itavc 
a purple backgnjund^ If you think that the compiler sliould just 
figure it out fmm the prefix of “Purple^ you arc going to be sorely 
disappointed. Ycai need to pick some method of NSWindow, 
override it, and then call a method to set the purple a>lor. For 
starters, write the method that sets the background color to purple. 

-(void)becomcPurple; 
t 

[self setUackgroutidColor: [KSColdr purpleColor] J : 

1 

Now all that is left is to call SxcomePuqile sometime early in 
the cteation of a window, liefore it is displayed, A particularly 
tempting target is inakeKeyAndOrderFront:. This melliod is ctilled to 
put a window on screen, and make it the key window^ (the window 
which accepts keyboard events). So you should dutifully write: 

(^old) makeKeyAndOrdeiFroiit: sL?nder; 

f 

[self becorafiPurplsl : 

[super makcKeyAndOrder?rent:sender}r 
i 

Now wlienever a PurpleWindow receives the 
makeKeyAndOrderFront: message it should change its 
background color to puq5k\ and then have NSWindow actually 
put the window on screen. 


Note: inakeKeyAntlOrderFronL: f)rol>abIy isn’t the besr place 
to actually make this patch. 1 picked i! as an exiimple Ixcause it 
is well known, quick and easy for developc^rs to undei'stand. 

If you ty|xxl everytJiing comxily, you sliouki lx able to mmpife 
ytxir new modified TextEdit, and gjve it a test. Ihe diange sliould 
liave aKsoluiely no ciTea at tliis point. Simply LTcaiing a suixlass of 
NSWindow dtxs ncx make it auiomaikally ikihc^ as NSWindow, nor 
docs it cause all windows to lxx.-omc PuqileWindows. At this point 
the only way you will get a PurpleWindow^ Ls if you cne^iic one in 
interface Builder, or programmitcally. 

To start the actual posing takes a single line: 

[Purp1f?W!ndow poseAsCla$s; [SSWiudow class]!: 

Your decision at this point is where to insert this line in your 
project. After you start llie fjosirig, all calls to NSWindow^ methods 
will insteaii be sent to PurpleWindow. Because of tills, the ideal 
circumsUincc is to |3erform the po.sing Ixfore any NSWindow 
olijccts are created. Ihis will guarantee that all NSWindow objecLs 
in your application art^ actually PurpleWindow ohjecus. 

Tile earliest [loim in the execiUlon of your application 
would lie the function mainO, found in t!ie file EclU_n-uiln.m. By 
making this line the first line in iiiainO, it will take place before 
any objects are created. Inserting tills early in mainO prtxluces: 

^import <AppKit/USApp1ic^tlon.h> 
limport “PurpieVinduwdr 

iriL main[!nr arge, const char *fiitgv[]) t 

[PurpleWindow poseAsClass: iJISWindow class] ]: 
return NSApplicationMaintargc, argv): 

I 

Build the projett again, run and test. You should find that 
doaimenr windows have no noticeable change. At first this may 
disappoint you, but the reason is that ilie white background of the 
document window comes from the NSText object that completely 
covers the background. You will need to look at windows with 
some bat:kgTX>und visible, such as the Info panel, tlie Preferences 
panel, and tlie Find panel. 'Ihese should Icxik like Figure 4, 



figm'e 4 

Posing can be a valuaiile tool, and a dangerous weafKin. 
Carele^is and unnecessary use can make programs difficult to 
debug and create strange effects, ff all you need is some purple 
windows for your application, you would probably lie belter Liff 
with just using a sulxlass. Reserve the power of posing for 
patching trlass that you lack source for, suth as die Appkit, and 
always keep the posing down to a minimum. 


Makcu 1998 • MacTkch 


RjiAPM.>t)Y IN VmviE 


19 



























Posing ln a Friendly Execiui abie 

If you can pose in your application, can you pose in an 
application where the source is nxjt available? 'lb pose, you need: 

I. Your class to Ikj linked into the target application. 

2- A call relatively e;irly on, w'here you can engage the actual 
[losing action. 

Some applicatioas will make this task easy for you. These 
‘‘friendly'' appliattions supjxjit the krading and linking of dynamic 
code in the form of bundles. Examples include Project Builder^ 
InterfaceBuilder, Viewer, and Mail, All of these applications load 
buntlles in one fonii or anotiier. 

For the next exitniple, the goal is to make windows in the 
ProjectBuildcr application use the same PurpleWindow as we 
used in lextEdii, but tins time I'll assume you don't have the 
complete source to ProjectBuildcr or Yellow Box. 

The application Project Bui id er^ supports the ability to load 
Bundles of crxle and rest>urces than can receive a notification 
when a projea is opened, closed, an other various useful ihings, 

A Inindle is much like an INTT in that it offers a sedion of 
exetaitable axle and resources like iimges, all packaged as a 
single unit. Tlic biggesi difference lietwetm these two is that an 
INTT contains code to patch the Macintosh System on startup, and 
a bundle contains loadable code for a single applicration. Another 
difference is that the Icxiding of INlTs ha[)ix.‘ns automatically, 
provided that they aiie in die proper place. Bundles are ustially 
only loaded by applications tlial explicitly look for them. 

Bundles are created using the Siiine tcxils, and a process very 
similar to building applications. You start by creating a new Project 
in Project Builder, but [)ick the type Bundle instead of ApplktJlion, 
You c:an then add and etlii classes to your bunLlle, build, and test. 

For the building of PmjtxtBuilder liundle.s, the task Is made a 
little easier by a piefeamce template tltat can lie fbuntl at 
<http:/Awww.ensuir»g.conV-'karl/RhapHaddRhap8undle.htmI>. Tills lemplaic 
Is a ProjetiBuilder bundle leady for use in ProjettBuilder, wiifi a 
default interface and class that only needs a small portion of work to 
lie u.seable. To sum, copy the template pix)jecl to some place 
convenient, like your home directory, and then open it in 
PiojcctBuilder, This type of project does noi liiive nay intedace, .so 
all the work Is done in ProjeaBiiiider. 

You now need to edit the bjisic class. As you can sec live re 
am several methods already crcaicd for the template that perfonn 
tile basic task of grabbing infonnation from tlie Project Builder 
application and setting up the noEification center to call nieihcxis 
on certain events. One of these methcxls Is tailed setup:. 
At:c:ording to the documentation, tliis method is called when the 
FBBundleHosl first loads the bundle. Tiiis looks like a gcxxl 
place to start your PurpleWindow posing as NSWindow. Insert 
this simple code snippet in the method builder^tarted: 

->-<void)builderStarted: 

I 

[PurpleWindow posoAsCl^ss: [NSWindow clanj;] ] ; 

I 

You wall also need to add PurpleWindow.h to the list of 
headers imported by the PB'l'emplate class. Add this line at 


the lop of the file PBl'emplacemi. 

fi^import TurpleWiiidow.h" 

Don’t forget to add PurpleWindow to the li.st of classes to be 
compiled inio this Bundle, You cun add it to Uie project by 
selecting the classes suitcase in the current project, and tlien 
dragging PurpleWindow.m from the Workspace, or the 
PupleWindow' application, to the classes suitcase. 

If ever^lhing was done correctiyu you should lx: able to 
build the application with no warnings or errors. If it worked, 
use tlie options button in the build panel to change the build 
type from “bundle" to “install", 'fhis will copy the bundle to 
-/lab ra ry / ProjeetBu ilder. 

Now that the bundle has been iaslalled you can add it to the 
list of bundles dial PRRimdleHost will load by sekxting Bundles 
in the Preferences panel of Projen Builder. It won't Ix" loaded 
riglii away though, you need to quit ProjeciBuilder and relaunch 
in order lor the bimclle to be loaded. 

When you laimcti Projet:tBuilder, you slK>uld lx able to bring 
up the Find panel and it sliould have a purple window as shown 
in Figure 5. If not, stmiething is wrong. Clieck to make sure that 
die project was htiih anti installed correctly, and dial all the .source 
code changes have been made to the bundle. 



Fi^ui'e % 

If you play with this new' crealiim for a while, you will 
notice a few important tilings reUilecI to tlie goals stated in the 
very beginning of iliis journey: 

The first Ls that ii works, IL is possible to write code that 
Significantly nxxiifies an application s framework even if you do 
nt)t have source for the framework, or the application. We were 
able lo patch at the level of the high-level framework, rather ifian 
al a low-level machine trap. 

ll is a clean patch, file code dcxsn'l liave lo patch a half- 
dozen ]x>ints to ctmsiandy detect windows and convert the 
background to [xiqile. And the patch only applied to the 
application that loaded it. It is easy lo see that if^ the bundle was 
Ixigus, it would only affect the single ap}>licaii(jn that loaded it. 

Application or Buntlle, the ctxle wUsS identical. Pur|>leWindow 
wasn't mexlified in tills example ai all. You merely a)pied it from a 
prcvifHLs project. 'Ibis is part of what made iL such a clean |Xitch. You 
can design new classes lo augment the A)>[iKit in an applit'ation, anrl 
then apply these classes to c)ther applications. 

The patch fell short in two very important goals: 

The patch only applies after die liundle is loaded. In the 
case of ProjeciBuilder, this was Ixfore any w'indows were 
CTeated. However an a[>|>ltt:aiion like Preferences docs not load 
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Do it your way! 


No application, no matter how many features it 
includes, can do everything. People and organizations 
spend thousands of dollars buying and upgrading 
software hoping to end up with a package that fills all 
their needs. 

There is an easier way 

FaceSpan™ 3.0 is a cutting edge interface design 
and rapid application development (RAD) tool which 
gives you the power to build and customize Macintosh 
applications quickly and easily 

Whether you want to create a simple floating tool 
palette that gives you quick access to your favorite 
scripts, have an idea for a new shareware program or 
need to tie together the functionality of multiple 
applications... 

FaceSpan is the answer. 
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FxaTTiple of an interface cmaCed in KiccSpiin. 

For additional information and 

UPGRADE PRICING: 

1-800-322-3772 (USA) 

1-801-226-2984 (Other Countries) 
1-801-226-8438 (Pax) 
(acespan@dtint.com (E-mail) 

hnp://www.facespan.com 
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your computing 
environment 


Features new to FaceSpan 3,0 allow you to; 


• Create interfaces and applications that 
conform to the Mac OS 8 look and feel. 


• Utilize new supported display objects 
such as lab panels, disclosure triangles 
and bevel buttons. 


• Define linkages that hide/show 
window items when another item is 
hilitcd. 


• Develop hierarchical menus and 
assign command key modifiers directly 

• Edit all your pn7ject scripts with increased support for 
external editors such as Scripter’"' and Script Debugger^. 

• Launch FaceSpan applications up to 5X faster. 

FaceSpan" 

A Product of Digital Technology luternationai 



New] Expanded 
tool palette] 
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"If you're a developer^ you've got to get TestTrack. 
Your bugs will hate you for it!" Coot tool of rk Difff 


Discover the tool today's top software developers are using lo improve the 
quality of their Macintosh and Windows applications—TestTrack. 

• Track bugs, feature request, problems, 5 ^ 455 2 + $l 49 eof|,l 

tuslotner informe lion, and more, , 'tioooi.U'aiJicA* 

• ttew! E-moil notificatirms-SMTP oivd MAPL '0 Order Call 8»8-fe83-6456 

• Wew! Import bugs via email aulomatkolly. or 513~683~6456 

• Produce con^ report. 

• Multiple users, lull security-lltsk engineers^ 
testers, tnonagers, even tech wrHers. 

■ New! improved hdp desk support. 

• New! Deferred defect numbering, extemol 
ottochment staroge, customer bug histnries, 
otxl mucfi, much, more. 

• Automolkally route bugs to team members. 

• Truck the history of eodi bug. 

• Save line otkI Improve tech support try 
giving Solo Bug, TestTruckS stand olone bog 
reporter, lo your customers. 



Download our demo todoy! 
hlt|i://www.seaplne.cam 


sales@seQpme.CQm 
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the executable code from the lamdle until it is actually needed. 
A sysleni wide Purple Window paich is not going to do much 
good if die user has to push a button in every^ app to gel it going. 

The patch only applies to Project Builder, whidi is a 
“nxiperative'' application. You still don'i have a way to get the 
execulaiile crxle of the bundle linked iiitcj just any mnning 
application. Even the actual API For how a bundle interacts with 
an application is different For cadi application, so the bundle you 
liave creiited works only in ProjeciBudder, 

Both of these problems can be easily solved if programmers 
would band togedier and CTcaie a common API, and agree to 
have a common directory where l>undles could lie located. 
Similarly, world peace could be easily adiicved if you just get the 
leaders of the world to agrt:e on a few thing.s. There are more 
tievelopers than world leader’s. 

An ExPLorTiVBLE Llnk 

'lliis article suined witli a li.si of what makes up an 
applic ation, and indicated that each of these was a target [Xiint for 
modiricatk)n. So far you Imve modified the restnin^es, interface 
files, and the execulalrle itself in source ccxle fcjnu. Wliilc each of 
ihesc^ points futs advantages and can help in the overall goal, tiiey 
don’t deliver the ideal hoped for: a patch to all applications that 
run on the .system. If rliere is a way to make patch every 
application, it must lay in the other items, such as the frameworks, 
window server, serv^er programs, or lire kernel. 


The kernel has facilities to allow loadable code and drivers, 
similar to ilie way diat Preferences allows you to load bundles, 
and since every program links to the kernel, it seems like die 
ideal place to find tlie atiiliUes required For this venture. 
TTowever, developing source code that dynamically loads into the 
kernel takes a great deal of discipline, and debugging takes a 
great deal of patience and usually tw^o machines. Also since code 
mnning in the kernel space can do anything, a much greater 
cliancc exists to trash your operating system Ixjyond repair 
Server programs like AKServ^r primarily serve in 
interprocess communication lx!tween applications and in 
[)roviding system resources, 'lliey have no facility for loatlable 
code, which results in a more difficult patch. They arc not 
going to do much to bring us closer to the goal. 

With a little work, functions can be sent to the 
WindowServer, however they must l:>e waltlen in Pt)stScript, and 
they tend to be liniiicd to affeding how the drawing or windows 
are presented, such as changing the shape or color of the cursor. 

This leaves framework.s, which also have no provision for 
loadiitg code. However, there ts a weak ]K>int in how 
frameworks are loaded lhal can be exploited 

How Filaheworks Work 

In the final step of compiling any Rltupsody program, the 
linker is passed a list of frameworks that the program requires for 
execution. This list is then emix-dded within a portion of the 
executable file. When a file is passed ttj the operating system for 
execution, it finds the needed frameworks, dynamically links 
them to the executable, and dien actually executes the program, 
rf a i:ommon framework was replaced %viili a framework that 
loaded bundles, it should lie possible to tiiake any application 
liehave as a cfx>fXTaitve applicttion like IhojectBuiJder. 

lb find out what fVamew'orks are common, you can 
examine various applications using the AfjpEdii applic:ation, or 
tlie command line tool "otoor. Casual exatiiination shows that 
three frameworks are used by every application, lliese three 
frameworks are called System, t’oundation, and Appkit, and are 
all located in /NextLibrary/k'mmeworks. 

llie System franx-wcjrk encompasses all Imic operating system 
cilfs, such as readO and write!). If tJiis framework was modified, it 
would afTect ncx cinly appliaitioas Ixil eveny exc'cutable file inc:luding 
cximmimd line ttx>ls and startup pixxx;dures. Patcliing this framework 
Is jiossilile, but an error cxxild lx diffinjlt to recover fitan. Without a 
valid Sy?^em.framework, your axnputCT can mX even sbiit up. 

The next possible framework is Eoundation. While not u.scxl 
by as many command line programs, it Is used by some, and 
therefore has many of the Siime prt>hlems as System, fra me work. 

Hull leaves AppKit.framework, which is a good choice 
overall. Tlierc are no [>oof progmnis depending on it, and if you 
totally destroy the Iramework, it is possible to repair the damage 
by ixHMing into single-user mode. ApfikiLframework also make 
.sensc% as most patches would lx targeted towards applications’ 
look and feeL It alstj lias another benefit missing from 
Founclation and System. To patch applic:atit>ns. you need ro load 
liundles at some point early in the applicalioiTs life. One of the 
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very first objects instantiated in an ay^plicaiion is the 
NSApplicatlon class, and this class lives in Appkit.framework. Of 
course, it is possible to make tile patches in the System or 
Foundation framew()rks, just with a greater risk. 

It would lx.‘ ixjssible to patch the actual binary code of the 
Appkit framework, however, such a low level patch is not 
needed. Instead you can move the Appkit framework to a new 
location, and then create a new' “patch” framework. If the “patch" 
framework is placed where the operating system looks for 
Aj)pkit.fra[nework, then launched applications will bind to the 
‘'patch" framework, if tlie patch Framework is compiled to 
depend on the new Appkit framework in iLs new location, both 
the patch framework, and the Apfikit framework would l>e 
loaded whenever a new application is launched. 

The AD\TiMnjRE Begins 

Tliis prcK'edure is not for iJic weak, timid, tired, forgetful or 
easily worried. Don't try lliis on a system that has important data* 
You would Ik' well advised to read this entire section from start to 
finish and understand it belbre placing your fingers on tltc 
keyboard. Also, Ix'rvveen the lime this was written and die time 
you read it, the layout of files may have changed drastically, check 
the Ensuing web site for any errala. Alxive all else, don’t come 
complaining to me when you find your system no longer Ixxas, 

In this prtxess you will end up with three fntrncworks: 

• OidKii, This is the original AppKti as supplied by Apple, 
modified to nin as either AppKit or OldKii, 

• NewKii. Tills will lie the new version of ApyiKit that you 
make using Project Builder. 

• AppKit. 'Ihis is what the system tliinks is the one tnie AyjpKit 
and c^n be toggled Ixick and forth lietween OidKii and NewKil* 

Moving the Appkit framewwk ( or any important 
framework) is a quick way to disable a system, but ti is necessary 
to get things rolling. You will need to either login as root, or 
bet:ome rcxii using the superuser command. As root, and using 
die command line, execute the following commands: 

cd /HEixtLibrary/Framevyrks 

Tliis will get your curreni working directory to lie the place 
for the rest of these crommands. 

akdir OldKit.framework 

This aeaies a new folder caUed OldKit that wilt hold the 
original Appkit* 

(cd AppKit^fr^tiicwcirk; gnutar -cf - , ) | (cd OldfCit.frameworki 
gnutar -xf - ) 

This whopjK'r of a eommand copies tlie contents of AppKit 
to OldKit, and preserves as much of the direaory stnicmre a,s 
possible. Frameworks tend to have a great deal of links* and 
using the copy command w'ill use more than twice the disc 
space. Tliis comm;ind may take several minutes depending on 
how speedy your hard drives are. 


StoneTable 

You thought it was just a replacement 
for the List Manager ? 

We lied, it is much more ! 

Tired of always adding just one more feature to your LDEF or 
table code ? What do you need in your table ? 

Pictures and Icons and Checkboxes ? 
adjustable columns or rows ? 

Titles for columns or rows ? 

In-line editing of cell text ? 

More than 32K of data ? 

Color and styles ? 

Sorting ? 

More ?? 

How much longer does the list need to be to make it worth 
$200 of your time ? 

See just how long the list is for StoneTable. 

Make StoneTable part of your toolbox today ! 

Only $200.00 MasterCard & Visa accepted. 

StoneTablet Publishing 
More Info & demo Voice/FAX (503) 287-3424 

htlp://www.telepoi1.com/-siack stack @ teleport.com 


cd OldKit - fraJDGwork 

Change into die OldKit fnimework for llic rest of the commands 
In -s Verijinn.i/B/OldKit OldKit 

This c:rcatcs an alias called OldKit in the current directory 
that links to where the actual copy of OldKit will reside. 

cd Vcr&ions/B 
cp AppKIl OldKit 

This copies the file AppKit to OldKit. Ihis is done so tliat 
you can have a pristine copy of AppKlr when AppKii.fmmework 
is linketl to OldKitTramework. 

At this point OklKii.frame work would seem to be ready to 
go. however there is a small bit of binary editing that needs to 
be done first. When applications are compiled to use OldKit, the 
atiual OldKit file you just created will lie examined, and inside 
Is a string tliat identifies die palli to this framework, whieh is still 
set to AppKit, To see tills string you can type the command 

otooi -L OldKit 

You must change this string so that NewKit can successfully 
link to OklKii. To change the string use a hex editor like HexEdit 
or you can download a prcjgram called App20ld that spec.ifically 
patches AppKit to OldKit at <ftpi//ftp.ensuing.com/xxxxxx>. After you 
edit the file, use otooi to make sure the change was imde. 

Now that this has been done, you have a new framework 
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called OidKit that is htnctionally identical to AppKit, just with a 
different name. In the mean time, the original AppKit 
framework still exists, and applications launched at this point 
still use the AppKitiramework. 

You now need to create a new AppKit framework that 
accomplishes two tasks. 

1. Augment live Applications class to activate the posing. 

2. Link to OidKit, so that original AppKit classes are available 
at at mime. 

*lhe framework is created in much die same way as an 
Application or bundle. From FK)jeaBuilder, create a new project, and 
selcxt die type erf Framework. You then need to edit several variables 
and configuration files to prepare die prtjjc^t for compiling. Add die 
OlclKir iinamework by adding it to the ftameworks suiiaise. Edit die 
file Makefile.postamble and change the following lines, so ihat the 
versions of this kit m;uch the original AppKit. 

DEPT.0Y_V1TIJ„VERSI0N_HAME - B 
COHPATIBILITY^PROJECT VERSION -- 45 
CURR£NT_PR0JECT^VEESi6k “ 45 

You now need to find a convenient place to start the posing. 
A framework does not have a mainO functioti, so you need some 
Objective-C methexi called early in the life of the Application, 
Ihe ideal choice is to make an initialize method for your posing 
category of Application. 

While not the very first metliod called in die life of an 
application, it does liiippen very early, and ustially fefore any nilis 
are loaded. Create a new class file callcxJ Applicatif>n_Fatch,m, and 
mtxliiy the header to Ik^ a t'litegory of Application. The add an 
imjilementation of tlie method initialize to the m file, 

‘' 'Application_Fatch*h” ‘ 

#iritarface ApplicationfPirtch) 

Send 

*' "Applicat lori_Fatch.]ii‘ ‘ * 
girtiplejnentation Application (Patch) 

Mvnid)iijitiaiize: 

I 

[FurpleWindov poafrAnCLis^: iNSWitidov claa i:]1 ; 

I 

^end 

The final .source for tliLs pnjject, is the familiar 
FurpleWindow class, w'hich you can copy from the previous 
example used in Project Bui I den 

If you compile and install, you ,sht)uld find a new framework 
in --/Library/Fra me works called ApjjKit.framework, this is the 
patched AppKit.framew'ork. Using AppEdit or otool, you should 
lx‘ able to see that this framew'ork mlies on the OidKit framework. 

You are now ready to install diis new^ fnimewrork as the default 
AppKit framewtjrk- By running these commands you can put your 
machine in to a ver>^ unstable Mate. Since you will lx: temoving the 
AppKit to a new loattion, the system will lie unable to find any 
AppKit resources that it may need, such as an open, save or font 
panels. If you tiy to use any system resounres in AfipKiiiraniework 


that are not already loaded, you may find that you pnigram hangs. 

From the command line type the following as root: 

cd /Ne^rtLibrary/Frameworks 

cp -r “/AppKit/AppKI l. frainGwark NevKit 

This copies NewKit from your personal library to the 
system library, 

ffiv AppKit.fraraowQrk safety 

ThiR novns AppKit,framework ta a folder named safety 

LN -s NkwKit APpKiT.I’RAMLWORK 

This creates an alias for NewKit called AppKit. frame work, 

At diis f)oint you should be able to launch new applicalions 
and find iliar familiar, yet somewhat sickening shade of purple. If 
Applications won't launch any more, relink AppKit to OidKit, and 
liicn pnx'eed to deliug by diecking the console for messages, 

Dcm'l play around too much. The system at this point is still 
very unstable. When the current atnning applotions were 
launched, (like Viewer, FrofedBiiQder, 'lenniiKil), they started using 
AppKii.framework to load system lesoiirces. Ibose resources are 
now in OidKit, and if you try to prim, open or save files, or 
anything else titai need.s a system rcsouire, you may lx: lucky to 
gel an error messiige, motv likely you will wedge things proity Ixid. 

li would seem therefore dial if you logged out and logged 
in, or rebooted, your entire system would lx- patched and you 
would lx* done. However, Sf>me of the early login prex'ess 
retjuires resources in A[5pkiL.framework, and they are not 
forgiving alxiiit the fact that the AppKit is not there, if you reliool 
at this jxrint you wilt noi lx: able to login. 

Thill siiid, you can fix this mintir problem by changing the 
Resourc:es directory of NewKit to t>oinT tf) rite Resources of OidKit, 

ci /NcxtClbrary/FranteworkR/NewKit 
rm rf Resources 

In 'S ../OidKit/RcfEonrccs Keijources 

After rebooting, everything should return to "normal”, and 
you should have a very jiurple operating system to play with. 
Ctmgratulatioos. 

ClAlSING 

When I originxiliy wrote tiiis hack during Macllack '97, it 
actually worked a hit differently. Instead of the patches being part 
of the patched Ap[>Kii. they were loadable bundles in much Ihe 
same way as ProjeclUuilders loaciable bundres. A front end cidled 
HuckManager allowed tile user to pick which patches were 
applied to which apphealions. While the overall design was mote 
flexible, and enablerl the user to turn off the [laich (something 
missing from this example), it suffered a great deal from slow 
launching applications, E;ich time an appltcaiion was loaded, 
several dozen buntlles would have lo he read into memory as 
well, and then applied to tlie running appliaition. 

Hopefully, Apple will develop st>me pLin for dealing widi 
system wide patches like the example given. However, their most 
recent FAQ on Rhafwtxly suggests that die entire idea of 
modifying the system as a wliole is going to lx? avoided, ® 
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InstallerMaker 4Ji iS t.he Complete Installation 1 
1^ Solution. Now your insliiller can automatically 3 
retrieve files tnm an WV site, so your users always get - 
the right software. 

Stuffll InsUllerMiiker 4*6 picks up where your 
comp her stops. 11 al jws you to easily create 
Hj custom installers Tor flistributhig software or J 
files. Using our iusbiiler reduces technical J 
V support calls due to end-user errors during ’ 
installation, saves disks {if distributing on floppies) 
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RHAPSODY 


by Andrtiw C. Stone 


Doing Objects Right 


Using modular objects 
with multiple nib files to 
make evolving your 
projects easier 


One of the most compelling features 
of writing .softw^are is that there are many 
ways to aecQoiplish llie same task. Itiis 
gives you a large latitude for creativity, bul 
also “the power to run off into the weeds/ 
(I overiirard an Apple Engineer using this 
plirase.) In iliis article 1 present some 
guidelines for creating usable and reusabk^ 
objects, and provide source for a search 
and replace panel. 

Our Rhapsody-based object draw 
and web authoring application, Creale^“, 
has 55(1 classes, and about 100 user- 
interface nib (NeXT Interface Bui Icier) 
files. 'Hits highly modular structure 
makes clianging one component trivial 
and speedy. Because the nib files are 
loaded only when needed, it alsr.) speeds 
applicalitm launching. 



Find 1 
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fsiii 

, Replace ^ acdfid 
En/ttre FUe 

FM Options 

Ol^rtorfCau | 
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Figure L 


There is always a temptation to add ol^jects directly to yt>iir 
main nib file becaase its easy to make objea connections. But 
this bloats the main nib and causes tlie app to take longer to 
launch. Moreover, it makes multiple documents almost 
impossible l:)ecause sometimes you need more than one instance. 
You also may want to take advaniage of Imcting the nib files only 
wlien needed. Tliis article will show you how to write an objea 
with its own independent interface file, and iiow to write the 
glue needed to Itave a menu item bring up that interface. Ccxle 
is included for a universal text find and replace object, 
"TextFinder/ which c'xin be added to the simple Wt)rd Processor 
from the Noveml>er 1997 issue of MucTeclt, 


sWord 

Tht! sourct; of sWord, iJtjr sLtjipk ridi text & graphics wcwxl processor 

#ijDport <AppKit/AppKit.h> 

#intertace VordD^iif'g^iTp ; NSObject 

i 

id th<iText: 

I 

(voidJnewText:[Id}sender: 

(voidjopenText:(id)sender; 

(void)saveText:(id)sender; 

^end 

(import "WordDetcgaie.h^ 
flmplementatior; WordDelegate 
‘ (voldlnewText;(id)sender 
t 

(tlieText set String : 

I 

' (void) opetiText; (Id) sender 
i 

NSOpenPanel *opetiPaiiel = iNSCpenPanel openPanel] 3 
If ([opeIIPanel riinModalForTypes; [NSArray 
arrayWlLliObjects;@"rtf“.§''rtfd'‘*NtlLt.l ]) I 

[theText readETFOPronFlle:topoiiPanel filenameJJ: 

I 

- (void)savfiText:(Id)sender 
I 

NSSavcFahol 'savePanei - [USSavePanel navoFanel]; 

[savoPariel setReqalredFileType : 

If (IsavePanel runModaU) i 

ItheText wrltoRTFDToFllR: [savePanel filenamej 
atomically:HO]; 

J 

I 

Send 


Andrew' Slone, :in early HyperTalk developer and ct^>auihor of "Tricks of the IfyperTaik Masters*' emigniled to the NEXT 
a)rnrnunity in 19H9, going r>n to write such NeXl‘ classics as TatiArt. Create, TkitaPbite diid :ii}reatiiy. 
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Tips and Techniques 

Thif> anidc won\ go into style issues — that's a topic for 
holy wars! However, here are some basic gukletines for 
developing stand-alone olijects that are truly reusable: 

1. Every iiit> file should have an owner object to which 
you say “+ new:” 

'Ibis means that a client need know only the object’s class 
name presenting a simple c'afling interface* By separating the 
details of the class (such as the nib name) from its use, y<ju 
ol>tain a cushion from changes to the tjbjcel* Then your client 
code l(x>ks like this: 

id eCoolObject [GoolGbjt*t:t new: (NSZoine *)zflnel; 

Note that the client detemitnes tlie iiicniory alltxaiion zone, 
the NSZone, in which to create the new ol’yfect by passing it as 
an argument. You can always pass m “NSDefatiltMalkK'ZoneCr, 
a functkin which returns the defatili memory allocation zone, or 
''[self zonel”, which remrns the zone of the calling abject. 

In our CoolObject’s + new: method, w^c have 

+ new: fNSZont? •)zone 

I 

self ^ KCoolObject allocWltbZorie:zofiEl tnit]: 
return self: /"dooH twrfcirf^-r thU! V 
I 

In its -init methexi, we load the user interface file: 

' init 
I 

Isuper initj: 

[NSBundle loadNibllained:8‘'Cooi0bject.Tiib" owner laolf]; 

/* place inXinlizatkin c<xk here 7 

te t u r ti self: T don’t ever ft th m] 7 

I 

Many objects require only one instance per class. F(}r 
example, Create uses just one ‘lexthinder object, which brings u]> 
the same panel each time. For ohjc-cLs like lliese, it is more 
appropriate tt> create a class method named + sharedlnstance, 
which might look like lliis: 

» (id)sb9redTtistance 1 

// siitM lasses need their own instartec if bcith dasM.*s are needed: 

id aha red Find Object * nil; 

// ihc real McG>y the first firm* thmiigli: 
it (IsharedFindObject) [ 

sharedFindObject = I [seif aIl<3cWiibZpone; 

i iNSAppilcaiion sharedApplicatioTi] /.one]] tnlt] : 

return fiharedFlndObJect; 

1 

2. Name your nib file the same as the owner's class name 

T'or each object which ha,s a visual re[)rescntation, your 
project directory will have ihrc‘e as,sociatcd files: the .h, .ni, and 
.nib. (if the nib file is loc'alized, it will reside in English.pro], 
Gennan,proj, French.proj, etc.) 

If fine owner'.s clas.s name coincides with the aib file name, 
the following generic code will load a nib file based on that cla.ss 
name, using the NSStringFromClass() function: 


Don’t settle 
for less than 
Everything! 

Objective-Everything™ 

■ A MUST-HAVE tool for Rhapsody! 

■ The preeminent scripting solution for 
Yellow Box. 

■ Rapid prototyping and exploratory 
programming as you have never seen it 
before! 

■ True language independence - use the 
best programming language for the task 
at hand, or even mix-and-match 
languages! 

■ Use Python, Tcl, Perl, and Objective-C. 

Objective-Browser'' 

■ View objects in a running program. 

■ Investigate program structure and object 
inter-relations. 

■ Class hierarchy, methods, instance 
variables, and other object information 
can be viewed and edited during program 
execution. 

■ Customizable and extensible. 

TipTop Software^ Inc. 

PO Box 30681 
Bethesda MD 20824 / USA 
301-656-3837, 301-656-8432 fax 
tiptop@tiptop.coni 
www.tiptop.com 
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Search the Site 

Search and find that ** 
article, news piece or 
source code you're 
looking for via the new 
Phantom search engine 
courtesy of Maxum. 

Article Archives ** 

These archives have 
thousands of pages of 
content in them from the 
histories of MacTech, 
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develop, Apple's award 
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with iay. inspect its dashes sr\d objects. Browse through their data stfuctures. 
interactj^iy send messages. £ven modify the behavior at run-time. 

The sampte screenshot !ihows five Interaction With Rhapsody's Draw.app. 
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triple a plus 

Joy Explorer 

by AAA+ Software 

Jump-start your Rhapsody development 
with Joy: 

Q Extension to Rhapsody's Interface Builder® which 
permits implementation of prototypes right within 
Interface Builder* - no need to use any tools except 
Interface Builder*, no need to compile and link, 

Q Graphicaf application inspector for inspecting 
classes, instances, methods and data structures 
inside any Rhapsody application. 

B Interactive sending of messages to objects. 

B Example programs with full source code, 
including source code for application 
inspector. 

Please visit our website: 
http: //www.aaa-p I us.com/joy/ 

Price: $ 69 

Email your order to: 
o rd e r@a a a-p I usxom 

Order NOW! 




Best Tool for 


New Technologies 


^iinport <AppKlt /AppKlt. h> /“ tvcrytliii^ you occd V 

- inlt 

I 

// Giniinuc ihc de?iignaird iniriali7j:r chain: 

[super inlt]; 

// hare s a fulkr invocaiicm of *kiadNii)Najncd:" which shows the loadutg of the 
// dk iiofun wiili the kcy valuc i>air jNSOwncr which lias a vaJoc of "self 
[NSBundle loadNibFile:I[HSBundle uainBundlel 
pathForReaoiirce iKSStringFromClasE ([self class]) 
ofType:e“tilb-J 

cxLetualNuneTablc:[NSDicllonary 

diet 1 oiiaryWitbobjt-ctsAndKeys:self. e^NSOwtier", nil] 
withZone: [seit zone]]: 

// pUcc txhtT itiiTLiJiz4lioii code here 
return self: 

1 


By making our object a siibcUiss of an object whicli uses 
ihi.s code to load a nib, we never even have to even write a 
new line of code — the nib with the name of our subclass 
will be loaded automatically. 

Apt class naming Ls one of the mo.st important aspects (jf 
creating comprehensible, not reprehensible, code. Tlie name 
should clearly and concisely describe the object's function. When 
my aistom class is a subt^as-s of an NSObjeef 1 like to include the 
supcrt:la.ss name in my class name. For example, SliderDualActtng 
descends from NSSlider. Usually, nib owners will descend from 
NSObject, so they can have more succinct descriptive names, 
such as AlignPanel, TextFinder, or OpenAccessory. 


3* Use the power of Ohjective C 

Wc would like any text ofijeci to \k* able to use our 
TextFinder's searcli and replace functionality, not just our own 
custom subclasses. Objective C allows us use eategork-s to add 
metho<Ls to existing classes. We can extend NSTextView with a 
c:aLegory TextRnderMetbods. w'hich contains the search and 
replace methods. Then any NSTextView in our application will be 
able to respond to methcxls like findNext: or findPrevious:. 

One note of caution alKHii categories: if you add multiple 
categories to a class and define a jnetluxl in more than one 
category, which method w^ill be used at runtime is 
undeterminable. Be sure to use categories carefully. Someday 
categtjries may be thouglit of as die Object Oriented GOTO, but 
they reveal tlie jx>wer of a dynamic aintime system. The full set 
of metliods diat we extend the NSTextView class are defined in 
“ N ST extVie wTe xiFi nde r. m ”. 

Objective C also provides sulx'lassmg, wfiich allows us to 
reuse classes by modif>dng their functionality' to Ot specific 
applications. For example, in specific text objects, we might want 
to provide the capability to ase regular expressions in our search 
strings. We could subclass TextFinder and mcxlify a few^ of its 
methods without having to rework the w'hole object. 

filmplementation NSTextView(TextFinderMethodfi) 

{voldlorderFrontFlndPsnel:fid)sender j 
// no Lh used - insiead, wm gmb rliL* sbajttltrLsuncc:: 

[ ['rextFinder sharedlnsiance] ordcrFroTit F i ndPanel: sietider] : 

I 
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4, Use the power of the AppKit 

Your interface ciepencis on being able to cause various 
controls (Iunions, menu ilcms) U> trigger actions in your code. 
This is easy with die TextFinder object and die TextFinder nil) file. 
We easily can create the neceasary connections in tlie Interface 
Builder, fiui now that you’ve followed my advice to use modular 
design and have created many individual nil) files, how do you 
connect the menu items defined in die main nib file to taigeLs in 
other nib files? How do you connect menu items tor finding text 
to the methtxls defined in die TextFinderMethc.)ds aitegory? 

The solution is the use of the AppKit’s “First Res[x>ndLT” 
hierarchy, 

3 BsWord-nib — ...CHfeV/orcl.ppc 

/ Instances Y^CIasses Y~Sound§ 


File’s Owner First Respond... 

Figure 2, 

In AppKit programs, if a menu item is connected to the Tirst 
Responder" stand-in object, then when the menu item Ls clicked, it 
sends its message up a hiemrcliy until it reaciies an object wiiich 
responds to tliat method. If no object in die liierarcliy rescinds to 
that message, the menu item automatiaiDy will be disabled. Each 
NSWindow in your application keeps tnick of which abject in its 
view hieiardiy lias first responder status. TTiis object gets the first 
chance lo iiandle messages sent to First Responder From there, tlie 
message Ls passed to tlie fifst responder's supeiview, tlirough the 
view hierarchy to die window^ and rlien to the window's delegate. 
If die message lias not yet liecn handled, it then gcx:s to the 
HSApplication and finally to the N.SApplication's delegate. 

SOj all you have to do is add die mediod’s name (also called 
“action") to your main nib's First Responder, and connect the 
menu item to that action. Tlie rest is done automatically by the 
AppKit objeas and the runtime system. Full instructions on adding 
the TextFinder to an application are the next section of this aiticle. 

5. Document the object 

Dcxiimenr what your ohjecl tloes and how it should be 
called. If you commented as you went, the documentation is 
mostly written. Make your API undersiandaljle by clearly 
explaining instance variables and methods. 

6, Don’t Panic 

I guess tiiis lielongs in every ILsl of guidelines! Happy Hacking. 

Adding the T'extFinder to Yoijh Am iCATiON 

Adding the TextFinder lo an existing project, like the simple 
word processor we built in Movember 1997, is as easy as adding 
the TextFindersubproj to your project, adding the more complete 


Edit menu available in Interface Builder's Menu palette, and then 
connecting these nienu ilcms with the method names tfial we 
have added to the NSTextView. Here’s a step-by-step guide: 

0, Download or type in the TexcFindersubproj files. 

T Open the pWord PB.project file in Projecil^uilder. 

2. Double-Click “Subprojects” which brings up a Open Panel. 
Select the “TexlFindcr..sybproj" to add this stibprojecr 



Figure 


4. I^>uble-Click lnteifaces->sWord .nib to launch InteifaceBuilder 
and load the main nib file. 

5. Select the “Edit” menu item, and clioo.se Delete. 


\ ^ "Hie MJSIm Text Font ^dOW Services || 


Cut «x 

Copy HC 

Paste mV 

Select All 31A 



Figure 4. 


6. Choose the “Menu” section of IB's Palette. 

7. Drag over the “Edit" menu item onto the main menu. 



Figure 5* 


Want to get up on a 
soap box? 

Send your opinions to 

<niailto:Ietters@mactech.com> 
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Spotlight Memory 
Debugger 

SjioLlighL is the first automatic memory 
debugger for die Macintosh. Instantly 
detea invalid memory accesses, memory leaks, bad 
toollxix parameters, stack ove™ites, memory^ relo¬ 
cation [imhlems, and more. Spotlight can find prob¬ 
lems in seconds diat miglit take you a week to fix by 
hand. 

SjKitliglu uses your XSYM file to automatically 
| 3 atch your PowerPC native iipplication, When 
Sfiotlight detecLs an error it brings up the exact 
source code line where die error occurred along 
with stack crawls, memory views, and progiam vari- 
alile usage infoniiation. 

No need to cliange your source code. No need 
to TOimpile. No learning curve whaLsoever, 

Spodight’s Object Oxle Replacement instrumen¬ 
tation inst^Tts cacJi PowerPC pKx:essor memory 
read and write instrudion in your code as it is run. 
Spotlight detects faulty memory reads and writes 
that ooiur between blocks, in released blocks, 
acToss multiple blcx;ks, ami outside of your heap. 


I NEW I 


VERSION 




Features 

m Stops your pre^Tam on met 
source code line wliere a luad 
memory write occurs 
m Complete leak reporting with 
MJUn:e axle stat Jc trace sliow- 
ing [K)ini of alloadon 
■ Fully validates parameters to 
over 400 Mac toolbox API 
calls. 

m Works on all heap alloations 
Mac Rx)lbox,C 'malioc\ 

C++ new and delete. 
m Supports any language that 
pnxlucesan MPWor 
Metrowerks XSYM file. 
m Full logging and ignore capabilities 
m API for fine tuned control 
m Piirchase includes one year sulisciiption to 
downloadable updates 
m 30 day money back guarantee 
m Available for secure electronic purchase now 
at our web site 


Requirements 

MachiiGsb or Mac OScompat^ ccft^acr with a PPC 01 or 
greater processor; /MM nsquirettu^nts tfory iiei)im£iirig tm tar¬ 
get ai^itkation sis!; 2 Mli bmi disk ^ce; Sy:^m 75 or iater; 
Metrowerks urMFW coTnpmibie symbolic fie 

Downlosid free demo at hu[);//www'otiyx-iechxoni/ 

$199.00 

TEL (^1)795-7B01 E-MAIL saie5(4'ofiy3t-t<?ch.ccim 

FAX (^1)79S-5901 URL 



Figure 6, 


8. Now, we must add die new methods that the NSlextView 
understancLs to the First Responder stand in ohjecL Tliese are the 
meliKxls we denned in NSTexlViewTextFindenm such as 
orderFrontFindPanel:, finclNext:, fmdPrevious:, jump'FoSelection:, 
and scroliroSelection:. 

a. DoulilcHrlick the First Responder icon to load Uic 
Classes subpiincL 


g sWdrriJiib 
f Instances Y:;go0rids^ 

IT 

First Respond. 

Figure 7 



b. Click the crossed “Action" icon to reveal the list of 
actions understood by die First Responder 



jClasses 



java.Iang Object 

0 NSObject 

.•#F 


Figure A 

c. Choose Classes->New Action, or Reairii to open a new, 
untided action. 



Figure 9. 
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d. Rename “niyAaion:” lo, e.g., ""orderFrontFindPanel:'' 

e. Repeat a-d for each of the other actions* 



figure 10. 


r Save yoitr interface file to update the First Responder 
completely^ 

9, Connect the inenii items tf) their conres|x>nciing First Responder 
action by control-dragging fnan ifie menu item to the First 
Resjxjiidei icon, and then seleeling tiie conecL action in 11 Vs. 



Figure 11. 


10. Recompile, and you are done! Type in some words and try 
out tlie find/rej^Iace. 


i H? CODF 

The TextFindcr.sul>proj contains TexlFinderh in Headers, 
I’extFinder.m in Classes, NSTcxtViewTextFtnclcr.m in Ollier 
Sources, and rextFtnder.nib in Interfaces, 

NxS Text VicwTc j£ir i rider m 

llib h ihe jiiuir which makes every icxi able to do seaali and rep]ace.These 
methods extend the orij^inal tunttionallt)^ of the SfSTextView in order to talk to our 
TextFinder object. Now, you can atid the complete "Edit" menu in IntcrticeOnrIdcr 
which ainOins the Find submenu, and it will just work.... 

^import <AppKit/AppKit.h> 

^import “TextFinder*h” 

^implementation NBTp.xtVi ev(TextF i nderMcthodo) 


- (voldJorderFroniFlndPanel:{Idlsendor I 

[[TextFinder sharedlnstance] orderFronLFiJddPancl: sendGrl: 

1 

- tvoid] findNext: (id) sender f 

[[TextFinder sharedinstancel findNext:sender!: 

] 

- (void! firEdProvioim: (fd)sender | 

[[TextFlnder sbaredinstance] findProvloLisjsender] ; 

] 

- (void}enterSelection:(idlsender [ 

NSRan^e range = [self aelectedKange]; 
if (range*length) I 

ffTextFinder shnredTTinranf.el setFinriString; [ [fif*! f ntring] 
sub.stringWitbRange: range] ] ; 

1 else I 
NSfleepO ^ 

[ 

[ 

- (void) JtJtnpToSelert Inn: (Id) sender I 

[self .scrol iRangeToVIslblei [sel f selectedRange] ] t 

] 

- (void)doFlnd3election;sender 
[ 

[self enterSeler.tion:.nelf] ; 

f 

TcxiFiiider.li 

if import <AppKit/AppKlt .h> 

ifd e r J ne Forwa rrl YhS 
ifdefine Backward NO 

^interface TextFinder : NSObject t 
KSString ‘findStrlng; 

Id findTextField: 
id roplaccToxlField; 
id igrioreCaseBurton: 
id f iTidNextButton' 
id replflceAllScopeMatrix; 
id statusField: 

BOOI. firtdStringrxbangedSinceUErPasTebciardnpflf^tfi; 

BOO]. 1 JiaLFlndWaaSuccessful I 


/* Common WhIv to get a text finder One insUmee of J'extlimier per app In giKjd 
enougli. V 

1 {id)sharedinstance: 

/* M:iin mcihoil for extefn:il ii!K-i*s; docs ;i finti in the fii-st rcspontler. 

Selects found miigc or beeps. 7 

- (BOOL)find: (BOODdirection: 

r Loads Lll lm\y 7 

(NSPanel MflndFanel: 

/* Gets the first icspomler ami returns it if it's an NSTcxtVicw V 
(NSTextVlew "ItextObjectToSearchln: 

/* tiCl/st! llic current find string.Will update U1 if is loiided */ 

- (NSSttiog MfindString: 

(void)setFindString:(NSString *)string: 

/* Mist internal mLihods V 

(void)appDldAct1vate:(NSNotlfieat!on *)notlfleatIon; 
(void) addWlllDeactivate- (NSNoLiricatioti ‘ 3 tiuLiflcaLiotj: 

- (void]loudi'lndStringFcomFasteboard; 

- (void}loadFindStritigToPasteboard: 

/* Methods sent from the find panel FI 7 

- (void)fIndNext; (Id)fTender; 

(void)findPrevious:(id)sender: 

(void)fijidNextAndOrdecFindPanelOut: (id)sender : 

- (void)replace: (id) sender: 

- (void)replaceAndFind;(id)sender: 

- (void)replaceAll;(Id)sender: 

' (void)orderFrontFindPanel:(id)sender: 

Send 

^interface NSiString (NSStringTextFinding) 
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InterLok 


TM 


Sell Your Software Online 


Features: 

• Wraps your software in minutes 

• Mac & PC Compatability 

• Try~Before'You-Buy, Rentals & Immediate Sales 

• LocalizaUe Interface 

• Unlimited Merchants 

• Key Disks 

• Unlock with your own website or with a licensed clearing house 


PACE Anti-Piracy 
1082 6/en Echo Ave. 

Son Jose, CA 9512S 

rtfone; (408) 297-7444 
Fax; {408) 297-7441 

Email: sales@paceap.tom 

Yfww.paceap.com 



- tNSRaTigerflndSuiMg;(NSStrln£ *)strillg 
selectedRange j C NSKaiigo J ce 1 crtedRange 
options: (unsigned)mask wiapt (BOOT.)wrspFlag: 


TcsiFIntlefjii 

Ckncrk’ lind/Rcpbcc funciiortality ftir tcxi. Uses new ten APLYou may ftidy copy, 
dLstfibutc and reuse Uic code in this example NeXT declaims an>' waminiy of any 
kind, expressed iir implied, as to iis fiiik-jis for any particular tisc. 

tfimporL <AppKlt/AppKit,h> 
tfimport "'rextPlnfler.h*' 

^implementation TextFitider 

(lc!)lnlt [ 

// if (here are memory allocation prutHems, we bail and return nil: 

If (!(scir [super inltl)) return nil; 

// in onJcr share Md strings among applications. 

//well EtgistcTC ot noiiftcaiianswhen theappactivatestirdeactivates: 
t fllSNotificationCenter defaultConterJ 

addObaerver:self selector:#seiectot(appDtdActivate:) 
natnoiNSAppl le.ationDidBecoaeActlveNotifieiil ion 
object:[NSApplIcHtion sharedApplieatlon]] ; 

[iNSNutirieuiionCanter defaultCenterJ addObserver:sclf 
selectDi::@selec'Lor [addwm Deartlvate:) 
name:NSAppllcationWillftesignAet1veKotification 
abject:iNSApplicfition sharedAppllcarion]]: 

// inrtialr/e oufseivcs ttt ibe empty string: 

[self eeLFlndSl rtng:^^*']: 

// here wc grab the last usetl Hndstring from other apps: 

[self loadFlndStringFcomPastcbnardl; 
return self; 


// these are the methods called wrhenever we get an achvaie or di-acticaie nntificatkm: 


- (void)flppDidAct I vate: fNSHotificatlon *)tioLif Icar ton I 
(self loadFindStrlngFromPasteboardl; 

J 

(void)addWillDeactivate:(NSNatilication •}notification I 
[self losdFindStringToPasteboard]; 


// and here is the woridiorse awk for sharing the fimistritigs among apps: 

' (void)loadFindStringFromPuslcboard 1 
NSPasteboard *pasteboard “ [NSPastoboard 

pasteboardWlthffafflCjNSFlndPboard] : 
if ([(pysLoboard types] containsObjeei:NSStrlrtgPboardTypa)) 
( 

HSStritig ^string • fpaHteboard 

St rlngFc rType: NSS t ritigPboa rdlype]; 
if (string && (string length]) I 
(self setFindStrlng:string]: 

flndStringCbangedSinceLastPasteboardUpdfate “ NO: 

I 

1 


(void)losdFindStringToPasteboard ( 

NS Pasteboard * pasteboard “ iNSPasLoboard 

pasteboardWithNuiiic: NSFI ndPboa rd ]; 
if (f led StriiigChangedSinoeLast Pasteboard Update) t 
(pasteboard declaroTypes:fNSArray 
arraylrfithOhjecL:NS$tringPboatdType| owner;nil]: 
[pasteboard setStrlng:[solf findString] 
forType^NSStringPboardTypc): 
findStringChangedSinceLastPasteboordUpdatc = NO; 

1 

1 

// Only one i)f Uie TcxiFmckr ohje^is Ls ever required: 
static id sharedFlndObjoeL ^ nil: 

+ (id)flharadlngtance I 
If ( IsbaredFindObject) I 
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s^iaredFindObject Uiself allocWitliZone; [ [NSApplication 
^ sharf^rtApplication] zone]] initl; 

return sharedFindObject; 


- (vaid)loadUI I 

// wc check m see if tlie rimTlexiFickl ivar is ni(, if so, wc loatJ the nih; 
if (IfindTextField) ( 

if ( {[usBundle loadNibNaffiedifi^TexiFinder'* £>wner:e€lf] ) I 
USLof^t#*Failed r.n load Tox L Finder .nib’'} ; 

NSBeepOi 

I 

// here wc autt>matlcajfy rcmt'mLxrr Uk user’s last locaiton tjf the fiiid panel: 

If (self ^ eharedFindObject) 

[ [findTextField window] fetFraraeAutD£aveNuJtier@"Fin<l"] ; 

// now update the seareli siring: 

[findTextField setStrlngValue; [self flndStrinjil ] ^ 


(void 3 d Ha Hoc f 
// don't litter 

if (self J- sharedFindObject) I 
IflndString release]j 
[super dealloc]; 

I 


* (NSStrlng *)findString I 
return flndString: 


- £void)setFlndStr!ng:(NSSiring 'Jstring [ 

// only' change if difftra'ni: 

if (tfitring IsHqualToStringtfindString]) ret urni 
// tarchil memory maiugcnifni is what makes a good prtygramma'! 
[findstring autorelease]; 
if keep a copy around: 

findString = [string copyWlthZone:[self ^onejl: 
if CflndTextField) { 

[findTextFleld setStringValue:etringl: 

[fIndTextFleld selectText:nil] ; 

I 

// here wc note that wc haven't set the global pasteboard siring ycU 
findStringCbangedSincel^stPasteboardUpdate = YES; 


// this method tries to IiikI the NS“fexi object that Is active 
// it wiU icium nil if none is active: 

- (NSTexiViev •)textObjectToSe3rchIn I 

id obj * ffKSApp maiftWlndow] firstResponder]; 
return (obj hh [obj isKindOfClass:[KSText class]]) 
7 obj : nii: 

(NSPanel *)flndPanel I 

if (! findTextField) [self loadiJll: 

return (NSPanel *)[findTextField window]; 


TThe primitive lor fimling; ibis ends up setting the status fieki (and beeping if 

necessary),.// 

(HOODfind:£BOOL)direction I 

NliTexTView ‘text - [self textObjcctToSearchInl: 

iastFindWflKSuccesafill ^ UO; 
if (text) I 

NSStrlng *textOtmtentS - [text string]; 
unsigned textLengtb; 

^ if CtextContents A& (textbengili = [textContents length])) 

HSRange range; 
unsigned options “ B; 

if (direction “ Backward] options NSBackwurdsSearch; 

If ([ignoreCaseButton state]} 

options 1“ MSCasernRensitiveSearcb: 
range - [textContents findStrlng:[self findString] 
selectedRange;[text seiectedRange] 
opt ions;optlonE vrapiYESl: 
if (range.length] I 

[text BotSelectedRange:range]; 

[text scroilRangeToVlsible;range]; 


lastFindtfasSuccessful = YES: 

I 

I 

I 

If (llastFlndyasSuccossful) [ 

HSBeepO ; 

fstatusFicld setStringVaiue;USLocalizcdStrlngFromTable( 
@*Not found" p Find Panel",, 

@"Status displayed in find panel when the find string \ 
is not found,'")]: 

I else I 

[etatusField setSt r1ngVa1ue:S"^]: 
return lastFIndWasSuccessfui; 

,[ 

(void)orderFrontFlndPanel:(id)sender I 
NSPanel ‘panel ^ [self flndPanel]; 

[findTextField selectTextisitl] : 

1 pane1 make KeyAndO rderFrontinll]; 


/"**"' Aaion methods for g^idgcts in the find p'Jncl: thcMr jihould all end up setting 
or clearing the status field ***** ^ / 

(void) flndUextAndOrderFind PanclOu t; (id) sende r f 
[findNextButton pHrforroClick:iill]; 
if ClastFindVIasSiicccsBful] I 

[[self findPanel] orderOutrsender[; 

J else ( 

[findTextField seieetText:nil]: 

1 


* (void)findUext:(id)sender I 
if (findTextField) 

/* findTextRckJ should be set 7 

[self setFlndString: [findTextFlel ft KrrlngValue] ]; 
(void)[self find:Forward]; 

I 

■ (vold)f1.ndPreviyus; Cid)aender f 
if CfindTextField) 
r findTcxiFicId should be sci 7 

[seif setFindString;[findTextField atringValuoJ]: 
(void}[self findiBackward]: 

I 

- (void)replace:(id)sender I 

NSTextView ‘text = [seif textObJectToSearchloI; 

If (Itext) I 
KSBeepO; 

I else I 

[[text textStorage] 

replaceCharacterslnRange:[text selectedRange] 
wlthString;[repiacelextField stringValue]]: 
[text didChangeTextf: 

[statusField setStringValuH:^"''] : 


■ (void) feplaccAndFind; lid}sender [ 

[solf replace;sender]; 

[self findNext:sender]: 

I 

iifdefine EeplaceAllf?copeHtir I roFi 1e 42 
(Ifdefine RcplaceAHScopcSelection 43 

* (void]replaceAll:(idJsender I 

USTextView "text = [self texTObjectToSearchln): 

if (Itext) I 
KSBeepC): 

I else [ 

MSStrlng ‘textContents * [text string]; 

BOOL entireFile “ repleceAllBcopeHatrix 

? ([replaceAllScopeUatrix aclectedTagJ 
“ ReplaceAnScopeEntireFile) ; YES; 
NSRange replaccRange = entireFile 

? USKakeRaiigelO. [[text textStorage] length]) 
: [text selectedRangel: 
unsigned options = NSBackwardfiSEarcb 
I C(ignoreCaseButton state] 
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? NSCai^pIns^nsltlveSearch : 0) i 
unsigned ruplared 0: 
it {findTexiFie^J 

[self setFitidString: |ffndTextField stringValue]] t 

[[text textStoragel beglnEditingl; 
while U) I 

NSKafigc foundRange = [textContentES 

rangeOfString:[self findStrIngl 
tjfjlions:options rangetreplaceRangc] i 
if [foundRange.length ^ 0) hreaR: 
replaced-H-; 

[[text textStorage] replaccCharattersInRange^foundRange 
withStting:[replaceTextField strlngVaiuel1: 
rep!areRange.length 

= feundRenge*location - replaccRange*1 orationr 

I 

[[text textHlorage] endEditingl: 

[text didChangeTexi ]; 
if {replaced ^0) I 
NSBeepO: 

IstatusFleld setStringValue:NSLocnl ixedStringFromTablet 
@"Kfit found^’FindPanel", 

@'*Stalus displayed in find panel when the find \ 
string is not found. 

] else I 

[statuefieid setSLtirgValue:[NSString 
localIxedStriagWithForinat: 
NShncsll 2 edStringFroBTable{§**ld replaced*, 

g^FindPenel*, @"Staius displayed in find panel \ 
when indicated nunber of matches are replaced 
replaced]]: 

I 

[ 

1 


@end 

^Interface NSString (StringTextFinding) 

“ (NSRange)findStrlng:(NSString 'letting 
selectedRange:(NSHange)sclectadRange 
options:(unsigned)options wrap:{BOOL)wrap; 


@end 


^implemetitation NSString (StringTextFinding) 

- (NSRange)findString:(NSString *)Btring 
seler.tedRange; (NSRange)seiec tedRange 
options:(unsigned)options wrap:(BOOL)wrap I 
BOOL forwards * (options & NSBackwardsEearch) ^ 0; 
unsigned length [seif length!; 

NSRange searcLRangc, range; 


if (forwards) I 

searchRange,location = NSHaxRangG(3electedRange): 
search Range, length length - searciiBange J OCation; 
range “ [self rangeOfString:string options:options 
rangeTsearchRangel: 
if {{range, length 0) wrap) I 
r If noi found Jook ii the fir*a part of the string 7 
searchRange*location ^ 0: 

searchRsnge^length ^ selectedRangc.location: 
range " [.^sel f rangeOfString: string op U ons : options 
range:searchRange]: 


1 

else ( 

searchRange, location * 0: 
searchRange.length ^ selectedRange.location: 
range ” [self rangeOfStrlng:string opt Ionsloptions 
range:searcHRangeJ: 
if {(range,length ={))&& wrap) \ 

searchRange,location = NSMaxRangefselectedkange]; 
searchRange,length = length - searchRange.location: 
range “ [self rangeOfString:string options:options 
range:searehRange]; 


return range: 

» 


tend 


Stop reading hex. 


Save time with 
Quadrivio General Edit, 
the fast way to edit data files 


(s) 


□= unmuo 


( 1 ) 


Deflne your file format 

• Easy, familiar C-like statements, 

• Complex formats handled by powerful syntax. 
■ Input is checked and compiled as you type. 

View, edit, or analyze your data. 

• Edit data directly in window, 

• Automatically check value,s, at your option, 

• File can be larger than RAM. 

Multiple uses: 

• Modify Finder Info and file parameters. 

• Also edit data in application heaps, 

memory handles, and parameter RAM. 

• View entire disk volumes. 


Quadrivio General Edit 

ADVANTAGES 

✓ Quick insight into data structure contents. 

✓ Easier than studying MPW’s dumpfile output. 
Faster debugging with clear display of data. 

^ Saves coding time with direct data editing. 


NEW 


On-iine version $195 


Start using General Edit just 30 minutes from now. 
Visit our web site. See, Learn, and Download, 


hftp://www.quad rivio.com 


Quadrivio Corporation info(§^quadrivio.coin 
1563 Solano Avenue #360 Berkeley, CA 94707 {510)524-3246 
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PROGRAMMIMC 

TECHNIQUES 


by F.C. Kuechmann, Vancouver, WA 


Conway’s Game of Life 


Another look at a 
familiar recreation 


numlxT of simple niles. 'Ihe cells form viirious paiierns as the rules 
are repeatedly applied to the ttiatrix. It is these jxitiems that make 
the Game of Life interesting'. 


The Game 

The Game of Life is a '"cellular 
aulomaton”* invented by British 
mathematician John Horton Q>nway. It First 
became widely known when it was featured 
in Martin Gardner's column in Scientific 
American in October 1970 and February 
1971. Since tlien it has taken on a life of its 
own (^troam-.X so to s|x.‘ak. It’s been 
discij.ssed in that publication numerous 
times and elsewhere, including several 
books targeted for audiences ranging Imm 
popular to professional scientific and in 
articles of publicatioas ranging from the 
popular audienee oriented Omni to obscure 
mathematics journals. By/c lias ventured into 
the subject on several cxx-asions, as have 
other computer magazines. See the 
references for a partial list. 

On the Internet, information on the 
game and versions in languages ranging 
from C to Java are widely available for 
online execution or download. A web 
search on the phrase “conway’s game of 
life” will lorn up numerous links u> 
follow and explore. There's also a six 
generation life editor, with THINK Pascal 
sourcec’ode, on Celestin's Apprentice 5 
CD-ROM* that's useful for exploring 
simple patterns of cell placement. 

The Life game field is a two- 
dimensional matrix on which celLs live, die 
or muluj>ly in accoixLince with a small 


The Rules 

For a matrix location that is occupied by a living cell: 

L Each cell with fewer than two neiglitK)rs dies from isolation. 

2. Each cell with four or more neighbors dies from overcrowding. 

3. Each cell witJi two t>r three neighbors survives. 

For a locration that is empty: 

1. Each cell with three neighbors births a living cell. 

This Version 

I implemented Conway's game in CodeWamor Pro Pascal on 
a PowerPC Mac 6500 using a 60 by 100 two-dimensional Boolean 
array. This army is map[^d to a 300 pixel high, 500 pixel wide 
area with a cell .size of 5 pixels square* as shown in Figure 1, The 
Figure 1 screenshot was taken after 18 generations in Random- 
Static mtxie with 500 live cells to start. 



Figure /. We game field. 


At the lower left of Figure 1 is a quad, 5x:ell oscillator, and 
in several places we see single* 3x:ell oscillators* and static 4<ell 


F,C Kiicchmafin <fk@aorie.com> is a programmer, hardware tlt^igner and coasuleant with degrees front the Urtivasiiy of 
Illinois at Chicago anti Clark College. He is building a programmers' dock that give.s die time in itexadecimal. 
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bl(x:les and 6-cell gmups. Tlie 3<ell binary (2-state) ascillaior and 
4-celI block are purha[>s the most coninion regular pattcms formed 
in the Game of Life when the field is initially rantitaiily populated 
with a syfficiently large ninnl)er of cells. Another common pattern 
is the 5-ceil, 4-srate glider whose states are shown in Figure 2. 



Figure 2 The smtes of the 5<elL 4-^iate glider 


Tile 5<elh 4-state glider evcnti:ally i:)ecofnes a stttic, 4-cell liltxrk 
at tlie edge of the field if enough generations are allowed to ela[3se. 

Figure 3 shows the stages of development of the quad, 
three-cell bmiy oscillator Siaiting from a hlcxrk of either nine or 
ten cells (the center |XJsiiion can lx.* either populated or 
unpopulated) ai left, tlie generations pnx'eed riglirward. Tlie sixth 
and seventh (two riglimiosl) generations alternate indefinitely. 



Another interesting starting cell pattern is a siraight vertical 
or horizontal line several cells long — ten is a good number to 
start with and evolves into an oscillator w4th 15 states, ''ir' 
patterns also give interesting resulLs, five cells to each vertical 
line, three to five cells in the crossbar. 

SoMt Source Code CoNVEPmoNS 

4be use of descriptive names for constants, variables, funaions 
and procedures makes tlie CodeWarrior Pascal sourcecode largely 
self-documenting. QxisUirits and variables tliat are glolral to the 
entire program liegin with the letters "ggc" (tionsrants) or '*gg** 
(variables), followed by at least one uppert:ast^ alpha or numeric 
ciiaraaer. ITiey are defined in the gloliaLs unit. Coastanis and 
variables global to a single unit begin with or "g”, followed liy 
at least one upixfiose alpha or numeric character. The MenuStuff 
unit holds menu loutincs, EventSluff the event handlers, etc. 

Running Lite 

On the menu bar are the standard Apple, File and (inactive) 
Edit nieniis, plus menus for Speed, Generations. Cells, Color and 
Delay, Tlie File menu offers only the Quit option. The Speed 
menu offers Wait Go button, Very Slow, Slow. Medium and Fast. 


4 SBBH EKFRNSION BOIIRDS 
Macos nvm ExnuenN BOARDS 



BOARDS WORK WFTH SERIAL SCANNERS. GRAPHIC TABLETS, 
LABEL WtlTERS, MODEMS, BDN MODEMS, AND OTHER COM 
TOOI.BOX SAWY HARDWARE AND SOFTWARE PRODUCTS. 


TO onon GAIL 800-367-8465 

■75DQ Connriitcy Onve • D ■ Hanover, MP □'/S 


www.creatiiie-$Dlutjons-inc.cani 

creatsaMaoLcom 


[)8 IS A FtBSSTERECF TtUOBAARK 


u^. 


speed is varied by changing the amount of delay invoked 
l>etween generations, lire Wait Go button option enables stepping 
a single generation at a time. 

The Generations menu allows .selection of the maximum 
number of generations executed pcT cycle. Defimli is 25, with 
options of I, 5, lO, 25, 50, 75, lOO and 200. A cycle temiinates if a 
static condition is reached, regardless of the generations .setting. In 
random mode, the play field clears after die seleaed numl^er of 
generations have passed. *fhe field is then randomly repopuiated 
and, after a two second pause, tlte generations cycle repeats. 

In manual mode, operation pauses and can be restarted by 
clicking the Go button. During pauses, you can add or remove 
living cells by clicking their loattioas with the mouse. 

The Cells menu allows selection of lite number (jf initial 
live cells in random mexie. DeFault is 500, with options of 175 
to 525 in 25 cell increments. 

The Color menu attow^s selection of live cell color Tlie 
options are Randcim, plus the eight standard MacinUxsh coloni — 
White, Black, Yellow, Magenta, Red. Cyan, Green and Blue. 

The Delay menu sets die delay after each cycle. Default is 5 
seconds, with options ranging from None to 30 Seconds in 5 
second increments, plus Wail (for tlie Go button to l>e pushed). 


March 1998 • MACfTEcn 


Conway's Game or Drt: 


37 


















































































THt Modes 

Life has four basic operating modes — manual, random, 
static and dynamic — dial are invoked in pairs of manual or 
random witli siatic or dynamic. In manual mode, living cells are 
birthed or killed by clicking their locations on the game field, 
then proc'essed by Conway's rules when the Go button is 
clicked. Listing J shows the mouse burton-prcKessing code from 
the FventStuff unit. The code first tests for routine mouse 
locations like the menu, system window and close lx)x via a 
case-staiement. Ihe last case-statement option, inContent, tests 
first to see if a button has Ixren clicked, tf so, it calls the 
DoButtons procedure lo process, otherwise it tests to see if the 
mouse pointer is in the active game field. If it is, the code that 
l^iiths or clears the cells is executed, 

listing 1- HandleMouseDown. 

ItatKlJcMouficDown 

procedure Natidletlou^eDovn; 
var 

whlchWimtctwE yindowPtr; 

tbePart^ X, Y, row, col : i.Dteg,erj 

BenuChoice: longinti 

thePwlnt : Pointj 

theControl : Controliiandler 

begin 

ggButtonFlflg := ratJE: 

thePflrt Find Window (gThnE vent, where, whicbWtodow); 

cajie LheFart of 
inHenuBar: 
begin 

nenuCholcc := MenuSelect[gTheEvent*where)j 
Hand 1 oHeniaCho ice {menuCbo ice}: 
end I 

jnSysWindovt 

SyatemClickCgTheKvonL, wbichWindow}: 
inDrag: 
begin 

CragWIndowtwhichWindav, gThefivent.where, 

qd.screenBits^bounds): 
ggXnBkCndFlag := TRUE: |forte mJniwJ 
RedrawBoard: 
end: 

inCoAway; 

ggDoneFlag TRUK; 
inContent: 
begJ n 

GeiMouse(thePolnt): 

ibePart FindConi rol(thePoint, 

whichWindow,tbeControl): 

if thePart <> 0 then 
DcButtonc{tbeControl) 
else 
beg] n 

(locate mouse pointer; if it's in i!ie| 

{playing licid, birth or kill cell at} 

Itlie moiLsc poimerl 
with thePoint do 
begin 

Y := v: 

X := h: 

end: 

if (X < ggWindRect.right) and 
fX > ggWindRect.left) and 
£Y < ggWindRect.bottoii) and 

(Y > ggWitidRect.top) then 

begin 

Y Y + S: 

X X + B: 

row y dlv ggcLifeSize; 
col l- X dlv ggcLifeSiEfi; 
if ggLifeBoardlrow. col] = FALSE then 
begin 


MakeliveCeil(row, col); 
ggbifeBoardlrow. col] TKliE: 
Inc(ggCellCount): 
HpdateCellCfiunt: 
end 
else 
begin 

KlllCelltrow, col): 
ggLifeBoardlrow^ col] := FALSE: 
Dec(ggCeliCountl: 
UpdateCellCount; 
end; 

end: 

end: 

end: linContentl 

end; (easel 

ggEuLtonFIag FALSE: 

end: 


In random mode, cells are birthed nmdomly by the program 
at the Stan of each qfcle (lengtli set via the Generations menu). 
That code is shown in Listing 2 

Lisdiig 2- NewCell and FillRandfim, 

NcwCell 

Procedure NewCell: 

(generates a psrir of random integers L,60 and l..Ulfl 
thoi tests the matri:? k)c;ition deftned by those numbers 
to see if it h ready occiipied by a edI.The pnw'ciss 
nmUnues until the irecessary cells are crcatal} 
varf 

X* Y, LryCount : longint; 
row, col: integer: 
begin 

tryCount r= 0: 

repeat 

(divisors 218 and 131 deierminetl by experiment) 

Y (Random + 327fi8) div 218: 

X ;= (Random f mm) dlv 111: 

row := Y div ggcLlfeSize: 
col := X div ggclifeSlze: 
if row < 1 then 
row ;= I 

else if row >59 then 
row 59: 

if col < 2 then 
col := 2 

else If col > 99 then 
col := 99: 

Longluc(tryCount): 

until (ggLifeBoardtrow, col] “ FALSE) or 

(tryCount > lOOOOOOO); 

if ggLifeBnarrflrow, colj » FALSE then 
begin 

ggLifcBoard[row. col] TRUE; 

KakeliveCell(row. col): 

Inc(ggCeilCount); 

UpdateCellCount: 
end; 

end: I NewCell 1 


FiHR:a[Hkitm 

procedure FillRandota: 

{births starting number of ccHs by repeatedly caUmg NewCcUl 
begin 

(erase lust count nums| 

ClearCellCcnintRoct: 
repeat 
NewCell: 

until ggCellCount > CggStariCellCount - 1); 
end: 
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The FIllRandom proecdui'e calls the NewCall procedure in u 
loop until the recjuired number of randomly-located cells have 
lieen birthed. NewCell generates two random integers, scales and 
convertiy tltem to a location in the 60 by 100 matrix, then tests to 
see if that location holds a live cell. If so, the selection prcx:ess is 
repeated; otherwise a new cell is birllied at the .selected location 
and the matrix location marked TRUH. 

Once Life Ix^gins api>lying Conway's mies the program c^an 
lx^ paused at any lime by clicking the Pause button. During 
pauses cells c'an !>e killed or hinlied by clicking their locations 
regardlcs.s of the manna I/random mode .setting. 

In applying Conway’s mles to the matrix, there Ls a cIkmcc 
of two approaches: static and dynamic. Both methotis count die 
number live cell neighbors had by each kxraLion in the 6000- 
ccll matrix using the ctxle in from die Action unit. 


Listing 3. CoiiiitNeighbors. 


<'.<)vintNdglil)()rs 


procedure CountNeighborslrow, col iinteger; 

war neighbors: integer); 
(counts the number of ILvt cell ticigfitH>rs of matrix location 
ddliicd by tow and column: rciurns count in integer neighbors, i 
begin 

neighbors := 0: 


(upl 

li rav > I then 

if gglri feBDurdirow ■ 1. col ) then 
iuc(neighbors); 

(down) 

If row < ggcMnxRow chen 

If ggLifeBoard[row + t, colj then 
Tnc(neighbors); 

llcfti 

if col > 1 then 

if ggLifcRoard[row. col 1] then 
Inc(neighbors); 

IriKhtl 

\f col < ggcMaxCol then 

if gglifeBoard[row, col + U then 
Ire(neighbors); 

(downright) 

if (row C ggcMaxRow) and (col < ggcMaxCol) then 
if ggLif©Board[row + 1. col + 1] then 
Inc(neighbors)j 
(uiileftl 

if (row > 1) and (col > 1] then 

if ggLif©Board(row 1, col - 1] then 

Inc(neighbors); 


(downlefti 


if Crow < ggcMflxRov) and (col > ]) then 
if ggLifeBoard[row + 1, col - 1] then 
Inc (neighbors): 

(upright) 

if {row > 1) and (col < ggcMaxCol) then 
if ggblf©Board[row - 1. col + 1) then 
Inc(neighbors): 


end; 


nie code uses a series of condiLionals to test matrix 
positrons neij^hboring the Ifx^ation passed by row and column 
numlx:rs, while accounting for boundary condiiions. 

Tlie static mixlf ctxle that calls the code in Listing 3 given 
in Listing 4. A local array is used lo store changes until the scan 
of the inairix is completed. Then die field is updated, along with 
the global array. Tlie SetMaxCol and SetMaxRow piioceclures 
called near the Ix-ginning of Listing 4 set local variables maxCol 
and maxRow equal to gltjhal constants ggcMaxCol and 
ggcMaxRow. CodeWarrior Pascal won't lei me use the global 




MkLinh 

Microkernel Linux lor the Power Macintosh 






MkLinux is a complete system, based on Linux 2 and the 
Mach 3 mkrokemeL It includes development tools (gcc, 
gdb, perl,X11R6.3, and hundreds of other commands. 

MTcLinux builds and runs most Intel-based Linux software. 
It works efficiently and reliably on a wide range of Power 
Macintosh platforms. Visit Apple Computer's MkLinux web 
site (www.mJdinux.applexom) and JVime Time Freeware's 
web site (www.ptLcom) to find out more about MkLinux! 

MacPerl: Power and Ease 

MacPerl is a rohost and powerful port of Perl 5 to the Mac. 

It runs under the Finder and MPW, supports Apple Events 
and Toolbox calls, and b generally quite nifty! For details 
on MacPerl and associated products (book, CD, etc.), vbit 
the MacPerl Pages (www.ptf.com/macperf}. 


Prime Time Freeware 
370 AUairWay,#150 
Sunnyvale, CA 94086 


info®ptfxoin 
(408)4^3-9662 
(408) 433^0727 Fax 


cimsianls directly in the for loop statements, demanding kx:al 
variables or cxinsuints. CodeWarrior Pascal also won't alkw a 
simple assignment such as: maxCol := ggcMaxCoL 1 wrote 
procedures, included in the Misc unit, to do the assignments by 
intTcmenting or dec:njmenting the varialjlc passed to it In a kxop 
until it equals ihc global coastani. 

Ustmg 4. Chcx:kStadcJ4e.lg|iboihoqc^ _ 

ChcckStaticNdghlKidKMKl 

procedure CheckSta I IcNel ghborhood: 

(Tests the 60 row. UK) col grid b)- first copying ihc global 
boolean array to a stnicsizc local array^OnintNdgtibors 
IS called for eacli nutrix posiiion.V&Ticn edis need 
10 be birrhed or killed, changes arc flngged in the local 
array only until the entire board has been scannesl.Then 
the imi arrays arc compared and the board uixIated.The 
local array Is copicxi to the global to update iL) 
var 

neighbors, cql* row. raaxRow, maxGol : Iniegnr; 
lif©Board : atrayll,*60p I..1001 of boolean; 
begin 

SetHaxCoKniaj^Col) : (set maxCol “ ggcHaxColl 
SetKaxRowtmaxRow); I set maxKow * ggeMaxRowl 

(copy global array into l4K:a( array] 
for col := 1 to niaxCol do 
for row 1 to TimxHotf do 

lifoBoard[row, col] ggLifeBoatdirow, col]; 

gChangei'lag FALSE: 
for coi := t to maxCol do 
for row := 1 to maxRow do 
begin 

CouatKelghborH{row, ool, neighbors]; 

(update local array' frtan neighbor count] 


Mahcjj 1998 • MAdTEoi 


Conway's Gaml of Ijff 


39 










if (neighbors > ggnKsxNcigiibors) and 

ggLifeBoardfrov* col] then 

begin 

llfeBoardtrov, col] r’“ FALSE; 
gChnngeFlag TRUE; 
end 

else if (nciglibors < ggcMinUeighbgrs) and 

ggLifeBoardtrow. col] Lbeti 

begin 

lifeBoardfrow^ col] FALSE; 

gChangeFlag := TRUE: 
end 

else if (ggLifeBoard[row, col] FALSE) and 

(neighbors ^ ggcBlrthNelghborsJ then 

begin 

lifeBoard [row. col] TRtlH; 

gChangflFlag ;= TRUE; 
end; 

end; 

(update the play field) 
for col I to naxCoX do 
for row ;* 1 ro maxRow do 
begin 

if (lifeBoardtrow, col] = TRUE) and 

(ggLifeBoardlrow. col] = FALSE} then 
begin 

(hinh a new cell in an unoccupied JocationI 
Inc(ggCeilCount); 

HakeLiveCell(row. col); 
end 

else if (lifeBoardJrow* colj - FALSE) and 
(ggLIfcBoard[row. col] = TRUE) then 
begin 

KniCeil(tow, col}; 
nec(ggCeilCoiint); 
end; 

ggLlfeBoard[row4 col] := lifeBoard[row. colJ ; 
end; 

ClearCellCountRec t; {erase just count nums| 

UpdateCnllCount; 
end; 


Haling 5 and Listing 6 perfonn siinibr funaioas for ilic 
dynamic: mode, the key differences iieing dial, in dynamic mode, 
tlie relative pexsirioas of the a>w and column loojis i.s significant, 
whereas in stiitic motle the order makes no differencx*. The glolFal 
lxx)k‘an vari;ible ggColumnlndexRag, togglcxl by clicking die 
Row/Column button, detennines the execution order of die loops. 

In dynamic mcxle, the matrix is updated immediately after 
counting neighlxirs. Listing 5 calls listing 3 to do the count, then 
calls listing 6 to perform die update. 

Listing 5, CheckDynamicNeigliborhood 

CbcckOynaniicNcighborhood 

procedure ChecknytiemlcNeighborhood; 

(calls Count Neighbors for cadi matrix location 
and dten calls UpDjircBtJani to make changes ioimcdiaidy; 
results vary with the relative pc^sRions of the row aitd 
column liKipsJ 
var 

neighbors, col, row, maxRow, maxGol ; Integer: 
ticks : longint; 
begin 

SetMaxCol foiaxCol) ; |sci tnaxCxil = ggcMaxColj 
S e t Max R ow ( ehu xRow J ; jset ntaxRim' = ggcMaxRow | 

gChangeFlag FALSE: 
if ggColumnlndexFlag then 
begin 

for col :■ I to majcCol do 
for row ;= 1 to maxHow do 
begin 

CcuntNeighborsfrow, col* neighbors): 

UpdateBoard{row, col. neighbors): 
end; 


end 

else 

begin 

for row 1 to maxRow do 
for col := 1 to m^xCol do 
begin 

CountMelghbors(row, col* neighbors): 
UpdateBoard(row* col* neighbors); 
end: 

end: 

end: 


IJslia g 6 . UjidateBoard.__ 

lIpdatcBoard 

procedure UpdateBoard(row, col, neighbors : integer): 

[called by ChcckDymmicNcighborhotxl after each call to 

Count Neighbors to make any needed changes to the board,) 
begin 

if (neighbors > ggcHexNeighbors) and 

ggLifeBoerd[row* col] then 

begin 

KillCelltrow* col): 
ggLifeBoardfrow. col] FALSE: 
gChangcFlag TRUE; 

DecfggCellCount); 

UpdateCellCount; 
end 

else if (neighbors < ggcMinMelghbprsJ and 

ggLifeRosrd[row* col] then 

begin 

XillCelKrow* col); 
ggLifeBoardfrow* colj :* FALSE; 
gChangeFlag TRUE: 

Dec(ggCellCount); 

Clou r Ce 1 ICountRe c t: {efasr just count niunsj 
UpdateCeIICount; 
end 

else if (ggLifeBoardfrow, colj - FAL*'?E) and 

(neighboiTS “ ggcBirthNelghbors) then 

begin 

ggLlfeBoardirow, col] TRUE; 

Make LiveCell(row, col): 
gChangeFlag TRUE: 

IncCggCellCount): 

UpdateCellCount: 
end: 

end: 

With the default static approach, which conforms more 
closely to the previously published versions and discussions of 
Gmway's game that I have seen, changes are not made to the 
matrix until it has Ijeen completely scanned. The dynamic 
approach makes changes immediately. The default mode 
combination Ls manual-static. 

PiAYiNG THE Game of Liff, 

The opening screen is a blank field with a control panel 
to the right. 'Ihe control panel shows two data windows, cell 
count and generations. There arc .six buttons initially labeled 
Row, Clear, Dynainie. Random. Go and Quit. In manual 
mode, cells are birthed or killed by clicking ilieir locations with 
the mouse. When the desired cell arrangement is in place, 
clicking the Go button begins execution. Crft changes to Pause 
and is u.sed to temporarilly Interrupt execution. The Clear 
button, enabled only in manual mode, removes all living cells 
from the game field. 

In random mode, the Random button is relabeled to 
Manual, and clicking the Co button initiates automatic operation 
that continues uninterrupted until manual mode is leselccted by 
clicking the Manual button, the Pause button is clicked, or 
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opt*ration is icnninated by clicking Quit, typing Coiimiaiid^Q, 
or .sclccLing Quit from the File menu. 

In I>ynamic mode, ilic button inially lal^lled Row Is 
enabled. It is used to .switch the relative positions i>f nested rt>w 
and column loops. In the default stare, the outer kx)p Is indexed 
by columns, the inner by rows. Clicking llie How button reversc.s 
the two and relabel.s the button to read Column, 

'rhe smk aj^pmach yields more oscillator and glider parterns. 
The Ixiilon initially labelled Dynamic is used to toggle between 
the two approaches, In Dynamic mode the button is reb[x.‘led 
Static and can be clicked to reselea tliat operating mode. 

ENHANCEMEM'S 

The most obvit^us way to add to the existing program would 
be to allow menu selection of some of the more interesting initial 
patterns, such as the 5-cell, 4-.state glider, 10 live cells in a 
luxizQiital or vertical row. Live-cell co-ordinates for the patterns 
could sffxed in records. Placing the cells would simply 
involve calling tlic MakeliveCell proc'edure the rL‘quired numlx^r 
of Limes with the proper row' and column values. 

Source Code 

Source code in CodeWarrior Pasrral and CodeVCarrior IDP 2.0 
projects is available ft>r download from Macieeb, Color 
Qutekdraw^ is recjuircd. 
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RHAPSODY 


by Kiis Jensen 


Handling a Changing Framework 


What to do when the 
latest update to your 
framework no longer 
provides an object 
essential to your project 


Data KtoHige and retrieval is an 
important part of mtjsi computer 
applications. In some cascs^ writing a 
ckx-unicni to a file is sufficient; in oilicrs, 
the infonnalion to lie stored and retrieved 
Is more complex, and your program may 
rely on a package of objccLs dial 
implement data storage and retrieval for 
you. Wliat do you do if that set of objects 
is no longer available? 

This article shows how the modularity 
of oliject-orienied programming allows 
one to quickly modify progmms without 
mmlifying code by plugging in a different 
set of objecLs and how the high-level 
Foundation Kit olijecLs can lie used to 
cjuickly code interim solutions. 

Aji os update broke t>ur application 

Stone Design's dataliase management 
applicatkm, DataPhile, suffered from an 
updated OS removing objects essential to 
the application. DataPhile wjis originally 
huill using the Indexing Kit package of data 
storage and indexing objects, a package that 


was included with the original NeXT^TTEP programming tools. Tlie 
Indexing Kit was never problem-free at its higher levels, and, at its 
lower levels, was difficult to port to other plaffoniis. As NeXTSTEP 
iiecame OPENSTEP and migrated to other hardware, the Indexing 
Kit disappeared. 

DataPhile needed a new back-end. While we were 
researching die ptxssibilities for replacing or fxjiting the Indexing 
Kit, we also wantcxl u> show that we could get the front-end up 
and running under OpenStep and Rhapsexly, The solution was a 
quick and dirty hack-end built using OpenStep Foundation Kit 
objecLs. We did not, al this point, want to change DaiaPhile's data 
storage paradigm, nor did we want to build a funaional and 
efficient b-tree package; we just wanted to "plug in" some 
c|Luckly built objects that would provide the surface functionality 
that we had Ix^en using in the Indexing Kit. Efficiency, either in 
space or time, was not an issue; speed in implementing 
.something that would allow us to demo our front-end under 
Rltapstjdy was our goal. 

An advantage of working in an objea-orientecl environment is tliat 
you can use a speedily-wrilten, temporary .set of ol'sjects that provides 
the funciioniility of the objects that are no longer available or provides 
a general storage mtxJel that works for your application. Later, you tan 
re-implenient the objeas more efficiently. Or you can use your objects 
as glue to implement your storage model using another set of objects. 
As long as you don't change yotir objects' interface, you don't need lo 
touch the rest of your code. 

Our solution may interest you if: 

• You're porting an applit ation and your data storage package 
is not available for your new platform. 

• Yexire developing an application and you haven't yet decided 
on what you're going to use for your data storage needs. 

• You're developing a small-sc:ale project and you need a 
simple, free persistent data store. 


Kris Jensen, ar the time an auomey for the State of California, boughi an Apple U in 198Q. It changed lier life. She taught 
herself RASIC, started taking computer .science courses, moved to New Mexico, entered rfie Ph.D. progmni in Computer 
Science at the University of New Mexico, bought a .Macintosh, pas,sed her compreliensive exams, became president of the 
local Apple Users Group in Albuquerque, met Andrew Stone, got NeXT represemattves to demonsinite the NeXT cube at a 
u.sers group meeting, jinncxl Andrew* in becoming NeXT developers, and didn t finish her Ph.D. Iiecaiise she was designing 
and writing NeXTSTEP software, Kris is happy to lx: l>ack in ilie Macintosh world with Rhapsody. In her spare time, Kris 
calls square dance.s around the country. 
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Implementing a fix with Foundation Kit 

Our solutioii followed these steps: 

1) Identify which classes and mctlKKls in the obsolete package 
are lx.ang used. We used five ebsses: tXSrore, IXSiorcFile, 
IXStoreDirectoiy*, IXBl'ree and IXHTreeCyrstir and we used 
most of the public API of tliose classes. Our data storage 
mcxlel was based on l>cing able to store key-value pairs (with 
the keys and value.s being of any size) and to retrieve tlie 
values either directly (via the key) or sequent tally. 

2) lm]>]einen! those classes and niethtxls. Don’t worry about how 
they ■’really'* wtjrk; our goal is to provide functionality without 
modifying our client code. For example, IXSiore was based on 
tite idea of “blocks” of storage: I kept the idea of hkx'ks, but 
they jiLst became id*s used for access into a dictionary. 

3) To do tlic iinpieinentation, figure our what you need to do 
and look for Foundation Kit clas^ses tliat will provide that 
functionality. We needed three things: to store key-value 
pairs to disk and lo access thase pairs directly (by key value) 
and sequentially. Ihe Foundation Kit includes NSFPLs 
{persistent property lists). The NSPPL class description in die 
Khapsrxly Foundaiitm Kit documentatioa. states: 

^'hike serialization, a persi.stent property list stores data in a 
binary fomiat, provides fast access, and is lazy. It also allows you 
to make incremental changes to an NSPPL (even one that 
contains tens of megabytes of data), while still ensuring that your 
data is never coirupted. In this sense, an NSPPL is analogous to 
a database. Because of their ability to incrementally store and 
retrieve data, NSPPLs are particularly w'ell-suited For working 
with large amounts of data (that is, data that has several 
ciemeots, that occupies a large number of bytes, or both).” 

NSFFLs can store NSDictionaries and NSArrays. 
NSDicfionarics provide fast key-value lookup, bur don’t allow 
sec|uential access in any kind of sorted order. NSArrays can 
provide sequential access. 1 decided to use ati NSFFL to 
implement an TXSLt>reFilc, an NSDictionary to implement an 
lXSif>renirectory, and both an NSDictionafy and an NSArray to 
implement an IXBlree. 

IXStore is '‘a transaction based, compacting storage allocator 
designed for data-intensive applications.’’ and IXSttxeFile puts 
the storage on disk, I'or a temporary bat:k-end, I decided to 
forego transactions and compacting and concunency control and 
just implement the calls my client code used: the transaction 
ctills from IXStore and the initialization methrxLs from IXStoreFile. 
Even though 1 didn't plan to implement transactions, I didn't 
want to remove the irdnsaction-oriented code from DataFliife, .so 
the methods had to be there. 

IXStoreDirectory and IXBTree conlbrni to the 
IXBlockAndStore proUKt)ls, which use die notion of a handle to a 
bicx k of storage. Bec'ause of tliis, 1 kept the idea of blot k numlKzrs 
alloc-aicxl by IXStore, but eliminated the idea of !>l(xks as consumt- 
sized storage units (meaning that somediing stored in an IXStore 
might extend over multiple blocks). Instead, each IXStore client 
wtruid Ixa assigned a block number which would provide access 
to that client’s storage. So in rXSiore and IXStoreFile, 1 needed to 


map block numbers to data. Since an NSPPL incorporates an 
NSDictioruiry to provitle access to its storage, 1 decided to use that 
dictionary to sioie bkx^k numlxT / data pairs. 

1 initially planned for the stored data to be die actual 
structures needed by the store clients: for example, to store the 
LKBlVee’s struct Lire (an NS Dictionary of key/data pairs) di reedy 
in the rcx>t dictionary. However, all NSDietk>naries stored 
directly in an NSFFL must use NSStrings as keys: this didn’t 
match the IXRTree's paradigm of arbitraiy data for Ixjth keys 
and data. So I used the rootDictionary of the NSPi*L to map 
l)lock numbers to NSData objects; the NSData contained an 
archived version of the objeci lo be stored, 

IXStoreOtrectory "provides access to store clients by name 
instead of by block handle.” 'Ibis obviously c:iillcd for an 
NSDidionary mapping names to a siniciure that would keep 
track of an object, ics class, and its block number. 

An TXRTrec "provides ordered associative storage and 
retrieval of untyped data. It identifies and orders data items, called 
by key using a t'ornparator function”. The information in 
an IXBTree oan he accessed directly by key or ser|uenually, by 
using an IXBTneeCursor to traverse the b-tree. It’s a fairly smndaid 
undergraduate computer sclenr'e project to write a l>iree program, 
but this Ls for a t[uic:k backn^nd, so I decided to use prefab paas. 
Direct access could lx [irovided by an NSDictionaiy mapping 
NSData keys to NSData vakies, Sequentiat access could be 
provided by a .sorted NSArray of keys. The stjited arrtiy could he 
built easily by using the s<7itedArrayUsingFuntlion NSArray 
methmi. A trursor can lie lepresented as an integer index into tlie 
sorted key airay. It can be po.sitjoned (for a key t!iat*s in the b-tree) 
using the method indexOfOlijccl. If tlie key is not already present, 
positioning Ixeomes a little more complicated; I implemented a 
<iuiek and dirt)' binary search on the array conients. If contents are 
added to or deleted from the key array, any c^irsors pointing into 
the array become invalid; I use an NSNotification to notify iJie 
fXRTreeCuraors tliat are accessing the b-tree. 

CtlNCXUSlONS 

Putting all tills together, I have a cover for the parts of die 
Indexing Kit that we needed (b-treeSj c:ursors, and storage) that 
will allow us to conriniie to develop the DacaPhile front end 
while we kxik for a replacement back end. IFs not particularly 
rf>hu.st or efficient, but it was built very t|uickly u.sing 
Foundation objects. When we decide on another storage 
package, we can rewrite the guts of the cover ohjecra without 
rewriting the code that uses the cover objects. Yt>u can take a 
kxjk at my b-tree solution in the example code provided at the 
MacTech ftp site <ftp://ftpmactech.cojn/>. 

I also found that a simple way to store and index record 
(jbjecls of some type is to create a b-tree that maps an id 
number to an NSData that holds the record (serialized in 
whatever way you wish). Then create index b-trees ihai map 
keys (have your records create their own keys) to the record 
id number. 'Fhis is demonstrated in the sample code that uses 
the b-iree code. B 
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WEBTECH 


by Klaus Hatfmann 


Writing ACGIs with MacApp 


It's easy and done fast 
using the simple class 
introduced in this article 


Introduction 

I receniiy was (and srill am) working 
on a pnjjctl invtJlving a daUibase to ]>e 
used on the web. 1 had a shon l<K)k at 
[Develop #29, March 1997] High 
Performance ACGIs in C by Ken Ifrquhart, 
but decided against it, for scvcnil reasons. 

• 1 don't like to leave the familiar 
enviromiieni of MacApp. 

• I want to use C++ not C. 

• It would have hem more difficult to dig 
into new ground than jus! using MacApp. 

• Performance wits not such an issue 
(and we will see that we still can have 
rea.st>nable speed). 

I thought it would take me al)oul a 
week to implement the ACGI tnierface but 
found tliat after two tkiys I was ready with a 
skeleton ACGI. Because MacApp needs 
more support 1 decided to publish tlii.s 
article. So, maylx? some older MacApp 
Applications can l>e found on die web soon. 

i use MacApp R12, since HI.? was not 
in a Slate to Ix^ used at the time I started my 


projea. 1 do not exj>ect major changes in die idea oi the 
implementation, but many details (e.g, streaming) will change. I 
do nut know whedier 1 will migrate our companies projea to R13. 

You should be familiar with the concept of cgis and ACGIs 
on the Macintosh in general and with ApplcEvcnl handling in 
MacApp. If not, you t^n still use my code, but will have trouble 
using / mtxlifying some pans of it. 

As an example I will show how to build a simple Form 
where you have three fields of a Ibnnula a x b = c. Tlie x can Ix^ 
chosen with a popup out of +, * and /. 

Building tiii; HTML-Form 

Forms can be used with two Methcxisi Post and Get. The 
obvious difference is that the parameters are invisible. 

Using Get you gel the familiar iirl ",„/myacgi.acgi 
?operandl=17&operand2=28&operalion-+&resutt=^''. Using 
Post the user can not see any arguments, but your ACGI gets 
them nonedteless. The post method allows larger argument 
sizes. Also, the argume[ii.s are conuiined in the keyPoslArgs 
otherwise in the keyPailiArgs. 

My approach allow.s you to u.se boxh ways. Before you start 
a huger projea you should decide whic:h of lx)th to use. 

Using PathArgs your ACGI can l>e used by an uri from 
everywhere, but the visible arguments may confuse the user and 
tend to become large. An other bad haliii is to use pa,s.sworcts in 
pathArgs. 'Ihe passwtjrd is useless (imho) if the user can create 
a Bookmark containing it. 

Using PosLArgs y<3ur ACGI can only be used by forms. Ihe 
user sometimes I^ecomes confused because the url stays die 
same all the time, but the contents chumges. The history also may 
kx>k stnmgc- Anyway, my approach does support lx)th methods. 


Klaus Halfmann is the leader of software devekipT^i^-^it *it the InTeCo Giiil>H, HtxlLspeyer (Cermany). He lias studied 
cximputer science at the university of Kaisefslaiitem and after his diploma has been Programming mostly on Macintosh and 
MacApp-1 le worketl mure ilian a year ai ihc StarDivLson (Hamburg) poniog the StarOffice 5-1 to the Maciniosh. Now at InTeCo 
lie Ls working on an autonomous project: DepotChart, a Stock Database program wiili a bi of niimeriail stuff and a 
sophisticated Charting Engine, currently targeted at the German miirket. 

If not programming on this projeil he manages the In-huusc Network, teaches his colleagues the many jispeets of computing, 
cares alx>ul tlie other projea.s and chats with customers on the phone. SometirTies, after the working hours he can be found 
playing AVAR A, a reaftime TIME 3D Game by Ambrosia, on the Internet. 
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Lets now look at the form: ('Ilie form found in the supplied 
archive is more complex of course.) 

<F0RH ACTiON="(iiysiC|i.acgi" METH0D=Got> 

< INPUT HA«E=”operandl" SiiU!=16> 

<SELECT Kame ope ration'*) 

<OPTIOH VALUE--+” SELECTEI»+ 

<OPTIOK mUE“"‘">- 
<0FTI0K VALUE^’"*'’)' 

<OPTTOK VAIJJE-”/”)/ 

</SELECT) 

< INPUT NAME="operand2” SiZE=l6> C/'TD) 

<1NPIIT NAME="result” SrZE=l^> </TB> 

<INPUT Name - "Calc" VALUE^'Xalc” TYPE=subT!iit> 

</F0RH> 



Figure 1. A shnple HTML Form. 


BinuLD AN ACGI WITH MacApp 

MacApp haK a chsH TAppIcCommand that descends 
Csurj^risc) from TConmiand and has the two subclasses 
TServerCoinniand and 1‘Client conmiand. d yon are not feniiliar 
with command handling in MacApp it’s now time U> read the 
Programmers Guide to MacApp. 

In our case TJierverConimand is our candidate, since the 
ACGI is a server for the Webserver (which in this case is the client). 
See^ It’s easy, the .server is the client and ... yes, you got it, fine. 

I Iiave written a ckss TACGICominand that descends from 
TServeiGommand and has a skeleton of routines needed for an 
ACGI, for parameter parsing and the like. So we go and create a 
Subclass of TACGlCommand: TMyACGrCommand. Tlie most 
important method (as in every other TCommand) is the DoltO 
method. You must override it to get your work done. 

As a framework 1 took the Skeleton example out of the 
examples supplied with MacApp. The archive does contain 
the complete skeleton code since I had to modify some parts 
of the code. 

MacApp uses a resource based mechanism to dispatcli apple 
events. The resource is the *aedt’ (ApplcEveniDlspatchTable), In 
order to enliance this table we need another command number first: 

//define c ACGI Command 404 

We can now define our own aedt lesource and cm use any 
number for it since MacApp locates all tables auromagically and builds 
a complete table. (Well numbers Ix^low 404 are used by MacApp) 

resource 'aedt' t4D4) 

f 

t *WWWQV» ‘sdoeX cACGIGonunand: 1 

1 : 



High-performance Relational DBMS 

Now available for Rhapsody 


Open System: ODBC, SQL, DAL Compliant 
Scalubtc rmni 68K Mac to IBM RS6000 
Proven RelisibiliLy (formerly P.INK SQL) with iastaJJatiom 
around the world 

Cross-plotformr Rhapsody, MacOS, Windows 95/NT, Sim 
Solaris, Linux,... 

Competitive Prices (10-user server for Apple I lardwure or 
PC only S820) 

Highly Flexible Weh Connectivity availabic 
EOF Adapter for OpenStep and Rhapsody 
Single-user Runtime available 



Developer Keys 


SNAP Innovation GmbH 
Tel: +49 (40) 30636400 
Fax: +49 (40) 30636333 
sale s @ primsbase .com 


Download Now! 

WWW. pri me bas e.co m 


Now we need an obfect which t:ares abt>ut the command. 
This is most nuLurully the application. In order to create our 
TMyACGlCommand we will have to override 

TAppl Ication;:DoScriptCommandO: 

(Widi MacApp R12 this is actually TDispatcherDoScriptGoinmandO 
hut dial is an otlier story.) 

Here is the interesting pan of r)oS<:riptCa)mniand: 


switch (aCorajnandN umber) 
i 

case cACCTCommand: 

PostComoiantKnew TMyACGTCommand(thli5. raeRsage. reply): 
break; 
default: 

Inherited::DoScriptCommand(aComraandNumber, message, reply): 


Some elder MacApp Programmer may wonder what 
happened to LMyACGlCommand. Well, it simply does not exist, 
since MacApp R13 will eliminate IMethods anyway. I .slopped 
using and implementing tiieni in all my current projects. 

Tlic lavSt tiling to he done Ls to introduce the new files to die 
makefile. If you are using the Metrowerks IDH, add them to the 
project, 1 use MPW^ and am satisfied doing so. 
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Rap-rimed !iy permjssJon on UFS, Inc. 


Doing the Rlu, Work 

First lets have a look at our Construaor: 

IMyACGICommand::TMyACGICoramand( 

T CommandRand1a r * it sCont axt, 

TAppleEvent* massage. 

TAppleEvent* reply) : 

TACGTCotnmand (i tsContext, message, reply) 

1 

I 

Tliere is nothing special heie. As a first approach we will create an 
empty ::Do1l() mctliod. Now our program should compile and run. 

Setting vp the Environment 
Meanwhile we should look at our related programs. We 
need a Webserver that supports ACGIs. 1 use Quid Pro Quo LO 
(1 know there is a newer version out there), but any other 
Mat: in tosh Web Server shtxild do. 

During the development prcKess a special setup is needed. 
In my archive I have included an alias to my webseiven This 
should remind you to replace it wixh an alias to your Webserver. 
On the other side (in your wel>scrvci-s nxjt folder) create an alias 
to your project folder and in your project folder create an alias 
to your program named ''myacgi.acgi^ llie Webserver will not 
recognize an ACGl until its extension is “ ACGr'. 



Your final setup may be different. As we will later see you 
wiU need additional helper or template files which have to be 
stored (as of thi.s implementation) besides the ACGl. But you 
may wish to avoid to make them public. So you might use 
aliases in a final setup, as well. 

A browser is needed, Keep in mind that people willi 
otlicr browsers and even oilier operating systems (you know 
those windows people) look at your site. So make sure that your 
forms look neat on different browsers. 

The ACGl should be ready now, so leLs set a breakpoint at 
the ::DoIt() Method. Look at your url 
<http:://yourmacyoyrcompany.yourdomatn/myacgi/multiply.html> and 
click at the “Calc'' button. As we expect we hit our !>reakpoinl, 
smile happily, and continue our program, 

You may find that you did not hit your breakpoint, if so check 
the following areas: 

• Look with ResLdit if tlie aedt resource is really there. 

• Set a breakpoint at I'DispatchercDoScriptCommand, maybe 
your override did not work. 

After hitting the breakpoint and telling the application to 
continue, the browser shouts at us “Document contains no data”. 
Indeed we did nothing to give him any data. 

Fujjng the Empty Method 

The building of the ACGl should have taken us about half 
an hour (if you arc familiar witli MacApp). Now lets fill our 
DoltC) method with something reasonable. First we should parse 
our arguments, 'llie lACGiCommands already has an universal 
weapon for parsing these nasty lines so we call: 

l?arseArgs(fAraSt keySearchAcgs) i 
// may \m keyR^stArgs in sonit other case 

fArgs is a Member Variable we have inherited from 
TACGICominand. It is of type TAssociation. TAssociation is one 
of the not so well known, all-round classes used internally by 
MacApp. For example it's used in MacApp MPW-TooLs nr for the 


DilberC hy Scott Adams 


L VE GOT A 5LIND DATE 
WITH niE LADY WHO 
W0RK5 AT THE LI&RAKT 
REFERENCE DESK. 



WHAT IF SHE'S 
UGLY? 



LOOKS AREN'T IMPORTANT. 
SHE SOUNDED VERY SflART 
OVER THE PHONE^AND I’n 
ATTRACTED TO INTELLIGENT 
WOnEN. 



et998 Uniled Feature Syndicate, liic. (NYC) 


UH...SHOULD I TALK, 
OR WILL YOU 6E 
READING MY THOUGHTS 
DIRECTLY ? 
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MAParam’i'ext/MAlieplaceTexT mechanism* In our case 
TAssociaiion is our Swiss army knife Lo cut our prohicm* 

After tlie call to ParscArgs fArgs is filled with name / value 
pairs w^hich c^n easily !>e retrieved. If you examine the routine 
ParseArgs you will find that it in turn calls InsertArg. This method 
can ly^ overridden, so that your ACGI cm intercept some variables* 

void TACGTConjuandr :Tns&rtArg( 

TAssociatlonSf argLisi* 

TStreaM' htmlStreanii^ 
const CPascalStr^ argNameJ 

The default implementation parses the stream (the 
AppleEveni arguments have mutated into a stream) up lo the 
next ik (ampersand) and inserts the name / value pair into the 
argList. You may, for larger data, call HxtractHandleO to extract 
laty^er parameters which do not fit into an 255 byte Pascal string. 

Handle ExtractHandle CTStream"* liLmlStream] : 

// Flclpcr for InscrtAig, cxtjaci Iljitidic from Stream up to the next & 


Well now that wc liave tile parsing done, lets extract our 3 
parameters and the button: 

// (Jet our operands md such 

CStr255 □perl. oper2. oper. result* messages 

if [f Argt; *EtEtryWltMey("\pCal€") H // Did the user press'Calc*'? 

fArgs*ValueAt {*'\poperandl’’,operl) //Look if wc liavc ad 
fArgs,VaIueAt (“\poperation” pOper j //our fields 


I use EntiyWitliKeyO just to check if the user really pressed 
Calc, this makes sense as soon as there is more than one button. 
ValueAtO extracLs the parameter out of fArgs and returns if the 
rntme was really there. The code after tlie if statement does the 
real work and 1 will skip it here. We create a result and put it 
back into our AppleEvent reply 

CStrZSS iiis£(operl + op^r ^ * * 

+ oper2 + ■' « '■ f result) i 
fReply->PutKeySttiug(keyDirectObj ect * ms g): 



• Create floating network licenses 
^ Tie license to host name 
- Tic license to user name 
•Tie to host TD 

• Allow as many users os desired 

• Have unlimited number of Jltcnses on a network ^ 

• Add licenses on the fly 

• Automoticolly unlicense if application is moved or copied 

• Generate expiring licenses for "full strength" demos 

• Vyoiks on Yellow Box for Windows as well as MACII/Rhapsody 

• Comes with sample app and license key generator 



yot/x fmef/os at 

S o f « r e 

www.stone^com/Liccnser/ info^stonc.com ( 505 )- 345-4800 


result at the bottom of the original page so that the user can start 
over with the next calailation? TACGICommand has already a 
build in mechanism helping you with this work* If you look into 
the file multiplyiitml you will find a line 

<111!result> 


Now ieLs compile and test it. May tie there are s^jme pitfalls 
we have not seen yet. 

1 made the following mistake: 1 used KeyAt instead of 
ValueAt, which works just the other way round hut wa*s not wiiai 
1 expected. If you find tliat you have no arguments at all maybe 
you should verify that you have got tlie right mix of Post / Get 
and keyl^ostAfgs / keySearchArgs* 


[ /myaogi/myacgi.3ogi?opgrand1 



Figure ^ Result of our first approach. 


OliTPUT via TiiMPLATli FlLLS 

Our ACGI works fiiie now^ but you will not be able to sell 
this as a final solution since the result page is almost empty, there 
are arrKmg otliers no back dinks. So what alK>ut showing the 


since “<!" stalls a HTML comment it will not show up in a 
browser* But die TACGICommand can parse diis son of comment 
and repLice the entire comment with a match from its .second 
TAssfxiation: fMarker* Instead of putting the result directly into 
the reply use 

fiiarker. InsectEntry ("\preeult’\msg): 

ItisertMatker (“ \pMul tiply Ti tial ”); 

Tills way we can put any whistles and bells into our lll'ML- 
page without affecting our core ACGL Ifiis approach has a flaw 
I should mention. The parser is not ([uiie intelligent and needs 
some recover)^ after an opening charaeter. So 

<lfRX[!!!mydaia> will not work since the parser analyse*s 
“<Ilk><!” finds it is no “!!!!” comment and skips both tags. In 
practice this is not a serious limilaLion, Isut a cause of unexpeaed 
errors you should be aware of. 
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Lets look at the result now: 



figure 4. Final appearance of Example. 


do i£e-example ym ^&gei a 
fpp ACGI unU start-flashing tbcprocessmiem m4r if. 

compIeto.)Kiur:re£piest 

leads 

*'MuWply:ht7nr is hot berreatb the executable. QWs^ 
UndpFmU not haw ; ' 


The error shows us a general problem. What happens if an 
exception is thrown inside our ACGI? MacApp is polite and 
shows us a nice alert-box, but our actual iiser is the user at the 
other side of the internet. Anotfier problem arises when our 
ACGI tries to open the dialog. During this time it is blacked and 
will not react to further reqttests. So you shcHild always wrap 
your DoItO code with a Pailurediandler and let the real user 
know wfiat lias ha])pened: 

CATCH_ALL // oop.s someone lias thrown an exception 

I 

CStrl5 num: 

CSTr255 msg “ "\p<B> CGI fatal error 

NimToString(fi.error, nm): 

msg +” num: 

lusg </B>\n^E 

fRepl^ >PutKeyString(keyDireetObjcct,msgj: 

// do not Kthtw. wc have handled it 

] 

ENDTRY 


1 think w'hat w^e did ean be done in less than one hour. I 
spent most of the time doing the actual work (and correcting 
my misspellings and the like) and had almost no work with 
ACGI related tasks. 


TACGlCoinmand;: TACGICatnmand ( 

TCnimEandJlatidlGt* itsContext. 

TAppieEvent* message. 

TAppleEvent' reply) 
i 

fSuspendTheEvent = true’ 

IServerConmtandtcACGlCoMiiand * its Context, kCantUndo. 
kDoesHatCauseChange, NULL, ’message, ’reply): 

fArgs. lAsaoclationO : 
fKarker.IAssociation0: 


If you look clo.se you will see that the caU to 
IServcrQimnmnd makes a copy of the message. This is necessary 
since we are asynchronous and answer the request at some later 
time. The original message will vanish and trying to access it will 
result in the rarely seen error crrAEReplyNotArrived (if I'm not 
wrong on this one). The error message is somewhat misleading 
since it appears when you tr^' to read the message, not the reply. 

If you fear about this prof)lem you can start parsing the 
command in tlie constructor and create a different constructor for 
TACGICommand, this is left as an exercise for the reader 

1 use MacApps THandleStream to do all the parsing, Tltis 
should be no problem for the input side of the ACGI since the 
arguments are usually small. The oulpul side is more difficult. 
Here we cannot stream our results directly into the Webserver but 
must pass it back in the apple event. On the other Hand we must 
he flexible enough to handle output of varying sizes. You can 
optimize tliis somewhat by adjusting the resize parameter 1 use 
to initialize the IHandleStreams, this way you can avoid 
excessive calls to Re.sizeHandle. 

Do It Youiiself 

If you really want to use my claases you should try out the 
following exercises before actually using it, yem will get aware of 
stjme more pitfalls my approach has: 

1, Go and modify the example in order to rein.sert the result into 
the form instead of displaying it in a separate part of the 
window. See the problem(s)? 

2, Change the <fOIiM> and the ACGI to use the Post method. 

3, Create a big text-input field (more than 255 characters) and 
parse iLs contents. 


SpiiiiD Considerations 

MacApp can queue several Commiinds if needed, so if your 
DoltO methcxl i.s short there should be no problem, tf you need 
some more time you will have Lt> do your wcjrk in chunks and 
use s^?me more sophisticated command handling. iTus way you 
can still be responsive if you must. If your Webserver does \he 1? 
communication mostly asynchronous the Webserver and your 
ACGI can gel optimal perfonnance out of tlie process. As far as 
I can see ‘Quid Pro Quo” 1.0 does not use asynchronous IP 
traasfers, hut 1 may be waong on that. 

One not so olwiou.s Speedhole opens in the 
TACGICommands Constructor: 


CONCXIJSION 

I hope I could show you that MacApp is a good foundation 
for writing ACGls in a short time. My solution is not perfect but 
t use it in an acmal project and our customer Ls ejuite happy (at 
least with this part of the implementation). H 

Want to suggest an article for the 
magazine? Send your suggestion to 
<mailto:editorial@mactech.com> 
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£ 9 ' Dave Mark, Brie Cloninger, and the Melrerwerks PalmPilot deix'hpmettl team, ©1997 by 
Metrotverks, Inc., all rights reserved. 


metrowerks 


Code Warrior for PalmPilot 


1’hts inonih, weVe going to talk with 
Eric Clotunger and the re.st of the 
Code Warrior for PalmPilot devdopment 
team. In case you haven’i seen one, the 
PalmPilot is a liandhdd oiganizer that 
offers contact management and 
calendaring functions, alt mg with the 
ahiliiy to nm 3rd party applications. 
Metrowerks CodeWarrior for PalmPilot lets 
you use your Macintosh to devekip your 
own PalmPilot appliralions, 

Eric Cloninger is the Engtnet:ring 
Manager for '"Scribbly Things'" at 
Metrowerks. He can be reached at 
ericc@metrowerks.com. When he isn't 
investigating the mysteries of sc^ftwarc 
development, Eric Ls hard at work playing 
witli his h>ur montJi old son, Elijah. In the 
few Ikhus a week left to itis own devices, 
he can be found concotiing rcdfxrs for 
homebrewed beer, playing softball, or 
watching llic Colorado Rockies blow it in 
the nintli inning. At niglit, he dreams of tall 
mountains, blue skies, and deep powder. 

Andrew' South wick is the Constructor 
for PalmPilot developer. Andrew^ and his 
evil twin, Werdna, can be encountered on 
Quake servers worldwide. 

Mark Corry^ works on the Mac- and 
Windows-hosted debuggers for PalmPiloi, 
When he isn't tinkering with the 
Metrowerks Debugger, he's tinkering with 
a '29 Mtxlcl A Ford. 

Honggang Zhang works on tile 
Windows-hosted debuggers for PalmPilot, 
Windows CE, Windows NT, Windows 95* 
and Java. Awuy horn work, she's applying 
her knowledge of chemi.stry to build tile 
perfea ciirrot cake recipe. 


Alex Harper provided Quality As.surdiice for CrxJeWarrior 
for PalmPilot. Although he has mcently moved on to other 
projects at Metrowerks, he can still be found lurking about the 
PalmPilot news groups and harassing the CcxleWarrior engineers 
to make sure his pet features make tl into the next release. 

Dave: Tell me about the PalmPilot architecture? 

Eric: The Palml^ilot uses a Motorola 68328 chip. It's so similar to 

the 680x0 chip itsed in tlie MacintcJsh that mf>st developers won’t 
notic:e the diflerence. l1ie device itself Ls niRiglily tile size of a 
deck of Inlaying cards and fits in your shin {xx:ket (or it would if 
tixat stylish QxleWarrior shirt you are wearing had pex^kets). (i 
lias a pre-ssure-sensitive display area that responds to a sly Ills a.s 
well as a data entry area where the aser enrers cliaracters. 

Unlike the Newton, the PalmPilot doesirt try to interpret 
the usera’ handwriiing. llie PalmPilot uses Graffiti — a system 
r>f strokes that are roughly equivalent to the bl(x:k alphabet. It 
rakes alxjut an hour to figure out the leticis and numliers and 
a few more hours to learn the S|xx:ial cfxtracters. lliere Is also 
a vimial keylxrard that jxips up on request for those obscure 
<’harac:tcrs (like how to get a grave accent character over an ‘eO. 

Cunently, the device has a lilack and white screen. Older 
models, tlie 1000 and 5000, came with either 128K or 512K of 
RAM. The newer mtxleb, the Personal anrl Professiomil, contain 
eitlier 512K or 1MB of KAiM. The Pers<mal and Professiomil offer 
a TCP/IP stack and the Prf>fessionaI has a built-in email client. 

As an organizer, the Palinl^ilot is useful. It has a date 
book, address lx)ok. ro-do list, and memo pad in ROM. If lliat 
was all it was, it wouldn't Ix^ any more interesting than 
something Radio Shack .sells for S39.95. The great thing about 
the PalmPilot is that a developer can wTite an applic:aljon f{>r 
I he device and upload it to tlie device (juickly and easily. 

When die user connecis the device to their Mac (or PC) 
witli a special serial cable and presses the “HotSync'' button 
on the front panel, the device synchronizes iiscif witli the 
data on die host computer. 'Hie mechanism tltat ^x^forms the 
synchronization is called a “conduit”. Other developers t^n 
take advantage of conduits to synclironlze their own data. 

Macintexsh programmers will recognize tlie way things 
arc done on the Pilot. Tlie 68528 chip (also called the 
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"Dragonball’’) is segmented the same way the 680x0 chips 
were, Ihis may seem like a limitation, but it doesn’t afFeci 
most people because a really latge Pilot application is 50K, 
“A-Traps" are used to make ROM calls just like tlie 68K Macs 
did. The PalmPilot runs w'hat Is essentially a single-threaded, 
single-tasking operating system. Dck^s this sound familiar? 

Some people describe the Pilot as a Macintosh, circa 
1984. I understand the analogy because the device Ls very' 
similar to the original Macs, but it dtx^sn't give the designers 
die credit they deserv^e. The Palm engineers did a great job 
building an OS dial met their design criteria, and, with 
CodeWarrior for PalmPilot, developers have great tools for 
writing quality applications for the platform, 

Dave: What is the PalmPilot runtime model? 

Eric: Before we disajss the specifics of writing code for the 

PalmPilot, it’s impcjrtant for potential developeni to understand 
how the device o^x-rates. Tlie PalmPilot ams PalmOS. The 
P'almOS is designed to ain on many devices, aliliough to date, 
the PalmPilot and the IBM WorkPad are the only ones dial use 
it. It's conceivable dial ihe PalmOS could be scaled to operate 
other consumer devices, such as a car navigation system. 

Tlie device contains a CPU, some memory, a serial port, 
and die user controls. Tliat’s pretty much it, Tlicie is no disk 
drive, keytioard, printer jxm, etc. Further, die device never tmly 
shuts off. When left idle or “shut olT’ from the power butroa the 
devic'c simply switches into a low power cunsumption mode, 
similar to “"sleep” on a PowerBook. The application dial is 
running at that lime is ,suij running, it’s just sitting idle in its event 
Icx)p. The next time the user hiLs a button, the prtxessor switches 
liack to active mode, and the application receives iLs next event. 

Anodier major difference from the desktc)[> world is dial 
everything about a Palmlhlol application (data, code, 
resources, etc.) is always stored in RAM. And since the RAM on 
device is static, changes from one program launch to another 
remain in place. Desktop application developers, who are used 
to the operating system krading a fresh copy of their 
afiplieaiion from disk every time die application is run, will 
find this to be a new experience. A problem with new PalmOS 
developers Is to unintentionally modify* memory where 
program ccxle resides. In I'act, wc take advantage of this feature 
to create breakpoints tor the debugger. The PalniOS includes a 
sel of APIs which i,solates program code from direct memory 
accesses, which helps to t^reveni these kincLs of problems. 

Tlie only PalmPilot application development languages 
dial are currendy available from Metrowerks are 68K a.s,strmbly 
and C. Pasc’al Ls not available fxx':mse a Pascal SDK hasn't lieen 
binlt and Javabyte ccxles am not fejcsihle liecanse die device 
doesn't have enough memoiy or CPU power t[j n tn a full Java 
virtual iiiachinc (Java fans don't despair, see die discussion of 
Jump at the end of dils article). Berardino Baratta has made €■*■+ 
support available with tile UKxst Rt.-cnl release of our aimpiler 
(version 4, due in January), but with no library support. 
DevelojxTs can use the language, but there are no built-in 
classes for stiings, streams, etc. 


Dave: What is the Pilot development miMlel? 


Eric: A PalmPilot application consists of many resources. Some 

of these resources are code, some of them are data, and some 
of them are visual elements. Is this Ixginning to .sound familiar? 

A PalmPilot developer will edit a form that comains 
user interface elements like buttons, lists, check boxes, etc. 
They can edit the form with ResEciii templates or visually 
with Constructor for PalmPilot. Constructor generates a 
header fde that has the symbolic names and values of all the 
forms and user interface elemenLs. 

The user application begins at PilotMainO. PiiolMainO 
receives a command, some command-specific data, and some 
flags describing how' die application was launched. Inside 
PilotMainO, the application repeatedly calls EviGeiEventO^ As 
events are retrieved, they are dispatched by the application to 
the system event handler, the menu event handler, the 
application ev*ent handler, and die form event handler, llie 
system, menu, and form event handlers are part of the 
operating system. The application event handler is a large 
“switch- statement that handles application events. 

The following code snippet, adapted fntm the "Starteri 
example project, shows some PalmPilot event handling ctxle, 

GlJord PllflLMainC Word CHid, Ptr cmdPBP. Word launchFlags} 

I 

if Cemd ““ ^ysAppLaunchCradNomialLaunch) I 
FrniGotoPoriit(HainFort!5): 

AppEventLoqp(1 ; 

1 

return 0: 

) 

Boolean KainFormHandleEvcnt. [EventPtr eventP) 
t 

if (evontP >eTypB = fraiOpenHvent) t 
FomPtr frmP ^ FrmGetActiveFortnU: 

FrmDrawForiatfrniP) ; 
return true: 


return false: 

] 

Boolean AppIiandleEvent( EventFtr eventP) 

If CeventP->eType = rmLoadEventl ( 

Word formld = gvgulP >data.frmLoad.formID: 
FnrmPtr frmP = FrininitForn](formld); 
FrinSetArtlveForijiCfrm?); 
if (formid ^ MainForm) t 

FrmSetEventRandlet (frinP, K.'iinForinHandleEveut); 
return true; 

1 

\ 

re tun* false: 

J 

void AppEventLnop(voirt) 
i 

Word error; 

F.vcniType event: 
do 1 

EvtGetEventtievent, evtWsit Forever): 

If (!SysHandlfiEvent[invent)) 

if (I KenuHandleEvenL(0, Sevent, terror)) 
if (1 AppHandleEvent (ttevent)) 
FraiDispatchEvent C&event): 

I while [event*aType appStopEvent): 

» 
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PalmPilot code is pretty easy to read. The PalmOS SDK 
designers did developers a favor when they decided to prefix 
every OS function call witli a three or four letter code for the 
manager that implements the fiinaion call and the header file 
that defines the call For example, EvtGetEvent() is in the 
Event Manager and is defined in Event.h. FrmDispatchEvenLf ) 
is in the Form Manager and is defined in Form.h. 

I>ave: What are the differences between the Pilot event 
model and the Mac event model? 

Eric: The event models are very similar. Tlie events that tlie 

application processes are similar to Mac events: events telling 
the application u> launch, events describing data entry, events 
describing menu selection, and evenis describing “taps" (the 
PalmOS equivalent to mtjuse clicks). There are events that are 
specific to the PalmOS, such as the event telling the 
application that the device was reset. A Mac programmer who 
has written event loop code will feel comfortable with the 
PalmOS event mtxlel after going through the tutorials that are 
included on the CodeWarrior for PalmPilot CD. 

Dave: Andrew, can you tell me about Constructor for 
PalmPilot? 

Andrew: Constructor for PalmPilot lets the user edit 
PalmPilot program resources. The application should 
look familiar to anyone who has used Ct>nsiruclor for 
PowerPlant. Figure 1 shows the form window, w^hich is 
where most editing takes place. 


Dave: Wliat differences are there between CodeWarrior 
Pro and CodeWarrior for Pilot? 

Eric: CodeWarrior for PalmPilot is a much less complicated 

package than CodeWarrior Pro. For PalmPilot, we use the same 
IDE, Debugger, compiler, and linker tliat ship with Pnj. We add 
a p^.>st linker called PilotRez that takes the output from tlie 
linker and modifies it to conform to ilic PalmOS application 
fonnat. We also ship Coasirucior for PalmPilot, which Andrew’ 
described above. Tliac's pretty much it. We throw in some 
d(x:umcntation covering the APT, some example projects, a 20- 
diapter tutorial, and a PalmOS cfK>kIx)ok. A full lasrall of the 
current version (Relciise 3) takes alx>ut 45 MB of disk space and 
CodeWarrior for PalmPilot can be inslalled on die same 
Macintosh as CodeWarrior Pnx 

Dave: What about debugging? 

Eric; Developers can debug tlieir applications in several 
ways: on the device itself, with a simulator on tlie Mac, or 
with an emulator on Windows and Macintosh. 

Mac programmers have an advantage over their 
counterpans on Windows liecause the Macintosh version of 
the PalmOS SDK includes a PalmPilot simulator that runs on 
68K and PowerPC Macintoshes. The simulator is a library that 
is linked against the user code to create a Macinto.sh 
application that behaves like a PalmPilot. The application can 
be debugged with the standard Macintosh dcl>ugger. Tliere 
are a number of diagnostic t<K)ls that are included with the 
simulator, so by the lime die developer is ready to deploy to 
the device, mo.sL of die debugging is done. 

Mark: The simulator library siinulates conditions on the 
PalmPilot as dase it can, but there will be bugs tliat won't 
show up until dicy are executed on the device. For that 
situation, developers can debug direedy to the PalmPilot. The 
Metrowerks debugger has been adapted to debug the 
PalmPilot via the serial port. ITie process of debugging is 
esseniially the same as debugging the simulator — the 
developer can set breakpoints, evaluate variables, step through 
code, etc. ’Ihe proems is slower because each action retjuires 
data I’le .sent ac:ros.s the serial connection to the device. 



Figure L Comtmetarfor PaimPUol form " editor 

In this ediLor, die user edits a form by dragging user 
interface elements from the catalog onto the iayoiit 
Appearance area which mimics the PalmPilot screen. The 
user can modify the properties of the elements by double 
clicking on the element. When the user .save's the form, 
Oiasiructor for PalmPilot will generate a header file with 
symbol names for each tjf die elements in the form. 
Constniclor for PalmPilot also has an icon ediior for editing 
the application icon, a bitmap editor for editing images, and 
editors for menus, menu bars, .strings, string lists, and alerts. 


Eric: Debugging to the PalmPilot is not diat difficult — TVe 

spent die last eight tnondis del:)ugging thi.s way. Thea* are 
some tricks tliat IVe learned along the way to make it easier, 
but a developer who knows how lo debug tlie Macintosh 
won't liave any problems debugging the PalmPilot, 

Honggang: Windows developers who want to debug away from 
the device also have options, IT-iea: Ls an application that nms 
on Window's allied CoPilot. CoPilot is a PalmPiloi emulator, 
derived from die old Amiga emulator. Since it is an emulator, 
the y.ser must acquire a copy of the l^almOS ROM image froin 
dicir PalmPilot. Once the user lias a working CoPilot, they 
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may debug their appJicaiitm with ihe MetrowerLs Debugger or 
they cdn use CoFilot itself to debug dieir applieatiori. Several 
versions of CoPilor are also available for the PowerMac. 

Alex: Retrieving tlie PaliiiPilot ROM cunenrly requires tliat you 

actually liave a Palml^ilot device. Some users have questioned die 
legaiit)' of retrieving a ROM image. It is not our place to toinment 
on the legal Issues, but wc can say dial Palm has never ol'>jected 
to deveiopers who own a PalmPiloi using a ROM image to help 
debug. 3Com has indicated they are looking for ways to supply 
PalniPilot developers wiiJi a dcbog-only ROM image. 

Dave: So, what applications have you written? 

Eric: My first PainiPilot ajqdicalion, Dot Dot 'I'wo, was three 

lines long and it put the device in a mode where it is ready 
to debug. Since then, I've i*>een redesigning and writing a 
program 1 wrote for rny PowerBook that lets me score 
baseball and softball games (actually, it lets my wife, Jackie, 
score rny softball games), 'I'he PalmPilot is a great data- 
gatherer and it will lx: perfect For this. 

Dave: You’ve told me the good news, what’s the bad news?! 

Eric: Tile bad news isn't that bad.,. 

The conduit SDK, which wc ship with CodeWarrior, is only 
available for Microsoft Windows. Also, as of the mast recent 
version, llic 0)ndui! SDK can only lie develojxtl with Mktosafi 
Visual C++ 4.1. No other version will work. 3Coni is cunendy 
working to upclate die Qmcluit SDK to Visual C 5.0. Sup|X>ri for 
other Winckiws compilers, including CcxIeWarrror for Windows, 
is [jlanned for futune releases. Mac develofx.‘is wljo want to 
write conduits ctiULmily have no oppominit>' to do so, although 
Palm may offer a Mac C'onduil SDK at a latei- tbte. 

C(xleWarrior for PalmPilot, just like the PalmOS itself, is an 
ever<hanging puKhici. Hie IDH, Debugger, ainifiiler, and linker 
are derived from t>ur Mac 68k tools, which have a history of 
stabilit\^ tronsrruanr for PalmPiloi is a new prextua anrl it hasn’t 
Ix^en released in its final form yet. It’s very usiible, l)ui we 
recognize tliat diem are a few more features to add and a few 
more bugs to kill. Constnictor for PalmPiloi requires a litde mom 
cam than Constnictor fex PowerPlam but iis pixigressing nicely. 

Dave: What kind of rcsourc:es are available for the aspiring 
Pilot programmer? 

Eric: Tlic new PalmPilot programmer has a wealth of 

information at their fingertips. We ship die OS documentation, 
tutorials, and \rAQs on CodeWiirrior for PalmPilot. 'Itiese are a 
good Stan, but there is so much more. From ihe very start, 
there was an active PalmPilot developer community on tlie 
InrerNet and the people in that community are willing to sham 
their knowledge, experience, and pain. 


Tltese are the places I'd start: 

• <www.massena.com> - This is Darrin Massena's PalmPilot 
programming site. Darrin is one of the people that make 
the piat.fiirm successful. Before CodeWarric>r was available, 
developers who wanted lo write for the platform could use 
Darrin's ’pila' assembler and * pi Ire' resource compiler to 
write iheir applications, 

• <news.massena,com> — Darrin Mas.sena also nms a private news 
sei'ver. There are (at last count) six news gn>ups on his server 
covering PalmPilot development, including one for 
CodeWarrior, Al Rincon and I patrol this group and answer 
questions as they arise. 

• <compsy5.p3lmtops.pilot> & <altxomp.syipalmtopipilot> - These are 
LlseNet newsgroups for tlie PalmPikjt. 'Ihe 'air' group was 
crre^ited and used extensively Ix^fore die official mmp' group 
could Ix! t reatecl. Ifoth are still in use Uxlay althtiugli most of the 
dlstussioas do ntx pertain to software development. 

• <www.roadcoclers.com> - RoadQxler,s is a site for developers of 
all mobile platforms: PalmPilot, Newton. Window.s CE, etc, 

• <www,wademdn.com> - Wade Hailer writes a number of 
prc jgramming PAQs, 

• <www.pilotgear,com> - Pilot Geiir is a commercuil site where 
visitors c'lin download freeware and shareware as well as 
purchase* commertial applications, aluminum easels, custom 
styiusc^s, and other PalmPilot goods. 'Ihe site am be searched 
or browsed. It’s very similar to the Mfl' hyperarchive of Mac 
shareware, only with a lot more poli.sh. 

• <www.hewgilLcom/pilot/indeK,html> - Greg llewgill is another 
person w4iQse contributions to the PalmPilot development 
community are numerous. Greg wmte CoPilot, the Windows* 
hosted PalmPtkit emulator. He also wrote Jump, which 
compiles Java classes to 68K a.ssembly. 

• <w3,teaserfr/-mpollet/Zilot> - Zilot is a PowerMac port of the 
CoPilol emulator. 

• <www.yahoo.COm> - There's a ton of stuff on Yahoo about 
Pilot, Roll up your pant legs and jump on in! 

• <www.metrowerks.com> - Tliis is more than just a shameless 
plug for Meirow'crks. Developers whti want to try out 
PalriiFiloi deveiopnient should pull down the PalmPilot Lite 
tools from our web site. With the PalmPilot Lite package, 
people who are curious about CtKleWarrinr for PalmPiiot can 
gc) through a tutorial, edit visual resources, edit code, build 
a[)plications, and debug. B 
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PROGRAMMER'S 

CHALLENGE 


hy Bob Booiistm, Westforcl MA 



Heij Peter Gev Home 

ULSt summtT, wliile he was on Ills way back to Perth from 
MacHiick, Peter Lewis suggested a challenge biised an airline 
schedules. His idea was to select tlic quickest route from an 
origin to a destination, given a schedule of flights between pairs 
of cities. This nionili's Challenge is based on Peter’s suggestion, 
but eml^ellished to capture the "probabilistic’’ nature of airline 
travel these days. 

Your jesb is to write a mutine FindQuickestRoute that will toutc 
Peter frcjiii liis departure Airport to hts anivalAirporl in as few 
simulated flight hours as ptwsilile, Peters trip l^egitis on startDay at 
startTIme. He has a list of airports to which he can fly, and an 
airlineSchedule of flights Ixdween pairs of those airports. The 
airlineSchedule consists of a flightNumber that will take him from a 
fromAirport to a toAirport, nominally departing at a 
scheduledDepartureTime, and nominally taking nominalFlightDuration 
sSeconds to get there, llie scheduledDepartureTime is expressed in 
tlie local time zone of the fromAirport, wliich Ls piovidetl as a 
timeOffset fretm Universal Time assiKiaterl with each of the airports. 
Some of the fligliLs in the airlineSchedufe tjperate f>nly on pajticular 
days, described in the operatingDays associated with each 
flightNumber. 

Eac:h of Live aiqxJrts Iras a minConneetTime, which Ls the 
mintmum amount of time following one’s arrival at the uiiporc 
before one can catch a cfinnetling flight. Tliis applies to the initial 
flight, which must lx scheduled to leave at least minCenneetTime 
after the startTime of Peter’s adventure. Each sul>sequent 
conneciing leg must alsti lx- sciieduled to leave at least 
minConneetTime after the aaual arrival time of the preceding leg. 

Sounds siiii[jle enougl^ so fai; right' Except that airplanes seldom 
dqxirt or arrive on time. So we have inmxluccd a little randomness 
in our simulatetl airline operations. Tlie actual dejxnture time (rf eiich 
flight Ls nxxleled as a random vaiiable with an exponential 


distril>ution, governed by the fxirametcT lambdaDeparture. 'Ihe 
duration of each flight Ls also mt deled as an ex|x>nential dLstribution, 
governetl by lambdaDuration. When you decide io take a flight, the 
callback imitine myGetFlightTime will roll itie exfx>ncntial dice for you 
and return flie number of minutes flie fliglii acm^dly took, nieasuretl 
fixan the scheduledDepartureTime. taking into account the deixiriure 
ck‘lay anti the duration delay. A few facts for those %vliuse pnjlxLbility 
tlicory is a little rusty: an exponential dLsiribuiion witii panuneter t has 
a prohibility <leasity funciion of Pcx|)(-tx), an expected value of (l/i), 
and a variance of 1/t^, 

The prototype for the code you should w'rite is: 

#ir defined( eplusplus) 

extuen "G" I 

#endif 

typedef char FlightNuitt(8] *MrporiKaniflf6>jl: 
lypedef emm I 

Sunday^O, Monday, Tuesday. Wednesday, 'niurr>day, Friday, 
Saiurdayl DayOfVeek: 

typedef struct MyTiuo I 

lonfi hour: /* b23,<>=nikjnisht V 

\on% mini /" t)-S9 V 

1 MyTfiifl: 

typedef struct 1 

AlrpectXarac name: T airium name 7 

MyT iSJe l imeO £ I s e 1; f* kteal ti me offetl rcblivc to t J iiivcnsaJ Time 7 
r 0 = Ciiiwmwidi, I’S,01—Eastern rime, cic, 7 
MyTime minConnectTitiie: /* minimum rime to make a conntttii»i ai Uiis airixtri 7 
I Airport; 

ty|3(jde f ^t nicT I 

FliehtNmn fl l^htMumbet: 

AirpqrtName f toinA I rport: 

AirportMame toAitpori: 

MyTirae scheduledDepartureTirae: /* kicil departurt timt Irum frumAiipun 7 
MyTinte noniinalFiightDuratloii; /* oominat tlighl duration 7 

float ] arobdaDeparture: T hr actual flight depurturc (mins) 7 

float lambdaDuration: f paiantctirr for act ual High t di irat ii j n (mins) V 

fioolemi opera f i ngDay s f 71; /“if optratingl^^vsfd]. flight v’alid on tlav d */ 

1 Flight; 


THE RULES 


Here's how it work.s: eat1i month we present a new programming 
challetige. I'lrst, wrife some code that solves the challenge. Secotjd, optimize 
your axle (a lot). Then, submit your solution to MacTech Magazine. We 
choose a winner based on code correemesss, speed, st3^c, and elegance (in 
that order of importance) as well as the subuiission cLite. In the event of 
multiple equally rlcsirahle s<jluiions, we’U choose one winner (with 
liunorable mention, but no prize, given tt> the runner up). The prize for each 
month'jj best soluticju L*; a SlOOereclil for Drwehyper Deptil^**, 

Unless staled ollieiwise m tl\e problem staternent, the fcdlowing rules apply: 
All solution.^ must be in ANSI com|jatible C or C++, or in Pa,sf:;d. We disqualify 
entries with any assemWy in them (except for challenges spcdfirally staling 
odanwise.) You may call any Madntwh TcKjIbox njuUne (e.g,, it doesn't matter if 
you use Ne^^Ptr instead of malloc), Wc compile all entries into native PowerPC 
axle widi compiler options set to enable all ai^ilable speed ^ximizations. Hie 
devt'lopmcnt envinminenl to l)e used for selecting the winrvi'r will l^e .staled in lite 
problnn. I jmit your code lo 60 characters per line or c'ompa'ss ami hmhex Ihe 


.solution; djb lielfjs witli e-mail gateways and page iayotiL 

We publish the soluliou and winners for each montITs Programmer's 
Challenge three months later All subimssions must be received hy the bsl day 
of the month primed on thi^ frrjnt txiver of tins issue. 

You can gel a head srarr <}n the Challenge by reading the Prograntmer's 
Challenge mailing list. It will be posted to the list on or l?efore the 12ih of the 
preceding monili. To pin, send an email to listscrv®!tsimall,xplain.com with 
the suhpc I '\snhscril>e cliallertge'A", 

Mark solutions “Attn: Progrumnier's Challenge Solution'' anti staid it hy 
e -1 nail to one of the Programmer's Challenge addresse.s m the "How to 
Conimunicaie Widi Us“ section on page 2 of this is,sue. Include the solution, 
all related files, and your contaci info, 

MacTech Magazine reserves tile right to publish any solution entered lU 
the Pn.ignimmers Challenge. Authors grant MacTedi Magazine the exclusive 
right to pubJish entries without limit;ition utxin submission of each entry. 
Auliiors retain copyrights for the code. 
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typedef long (*GerFlJghTTine} ( 

r mums actual flight dunirk>n from sdicdulcdl^cpartureTtmc in minutes 7 
Fll ghtKuin f 1 IghtNuinber t Oiglit number laJwm 7 


)J 


long Flndl(iuickestRoute( t 

AirportNarae depattur^AlE-port, 

■ r 

t 

r 
r 
r 
r 
r 


AirportNaiii£ arrivalAirporl. 
DayOfWesk startDay, 

KyTime startTime, 

Airport airports tl* 
long nuBiAirports 4 

Flight airlineSchedule[l, 
long numFlights, 

GetFllghtTiffle uyGetFlightTino 


mum travel time in seconds 7 
/* origin airjHirt 7 
destination airport V 
day the adventure begins (local time) 7 
lime the advemurc bq;ias (Itica] time) 7 
places to fly fmm/to V 
number of entries in airpoits[1 7 
flights to choose from 7 
number of rotnes in airlinc!k:hetlulel] V 
r callbacli that ptt^vides actuii Htght 
duration 


J; 

^ I f d 0 f1n od(_cplus plus) 

) 

#endit 

My test code will keep track of the flights you choose in 
the myGetFlightlime routine. It will ensure thai operatingDays 
and minConneetTime constraints are met, that the IromAirport 
for travel leg n+1 Ls the same as the to Air port for travel leg n, 
etc. Violations of these constrainis will result in a 24 hour 
simulated time penally. 


the constraints imposed by puzzle scjUiires where an “across'' word 
iniersecied a “"down” word. Ihe si)de of crossword puzzle fmnided 
in the test ccxlc and used to evaluate this Challenge contained 
many blocks of cells that were* 4x4 or larger, resulting in many such 
intersections. Mat uses a set of fittef_for_length_N routines to 
elTiciently propagate constraints imposed by the bitersections. 
When reading die inodesdy commented code, pay particular 
attention to the create_placements routine used to identify possible 
word locations arid to the tighten_oonstraints routine used to 
elimimite conflicting word placements. 

Five of the entries had not solved one or more test cases 
after ten minutes or more, exceeding my ability to wait for an 
answen In diese cases, a test time of 10 minutes was assessed. 

Ihe table below lists the lotal exeaition time in seconds for 
the fifteen test cases, code size, data size, and prrjgramming 
language for each ent^y^ ITie number in parentheses after tfie 
entrants name Ls ilic tolal number of Challenge points earned in 
ail Challenges to date prior to this one, Tlie entries marked with 
an asterisk are diose which did not complete one or more test 
cases ill die 10 minutes mentioned alx)ve, 


Test cases will inclucie several trials for each departure/arrivai 

Name 

Time 

Code 

Data 

Language 

pair to average out randomness. The winner will lie the solution 

Mat Hostetler 

0.37 

14196 

200 


that routes Peter to his destinalioas in die least amount of time, 

Brad Smith 

1,36 

7532 

61835 

C 

wliere time is calailatetl as cumulative simulated travel lime plus 

'ibm Saxton (12) 

1,42 

4132 

8 

C 

a penalty of 1 simulated hour for every' second of execution lime 

Jens Martin Bengaard 

9.76 

4108 

16628 

C++ 

required by your FindQuickestRoute solution. 

Xan Gregg (114) 

23.73 

4536 

224584 

c 

This w4ll he a native PowerPC Challenge, using the latest 

Randy Boring (73) 

74.36 

4260 

35158 

C 

Ct>deWarrior environment. Solutions may lie coded in C, C++, or 

Frnsi Munter (310) 

107.81 

5824 

16460 

C++ 

PasaiL 1’haiiks to Peter Lewis for inspiring this Challenge — he 

Sebastian Maurer (10) 

389.23 

3968 

112 

C++ 

w'ins two Challenge [xiims for the suggestion. 

Riiiiier Bruckerhoff 

606.03 

4609 

165577 

c 


{•) ACC Murjihy (34) 

2400,29 

6528 

10212602 

Pascal 

Tiuuit; Momhs Ago Winner 

Cl Mike Miller 

2433.70 

10052 

428 

C++ 

If tlie number of entries to the Decemlier Challenge is any 

(*) Fric Kenninga 

3m22 

6076 

188 

C++ 

jndicurion, many Programmer's Challenge readers are also avid 

(*) Steve Wozniac 

3925,92 

2836 

64 

c 

crossword puzzle-ists. Cfongritiilatinns to Mat Hostetter (Icxiation 

(•) 111, 

wm 

6780 

1732 

C++ 


unknown) for stibmiiltng the fastest of 14 entries Clueless 
Crosswords Challenge, llie pn>blem w^as to solve (or actiuilly, to 
generate) a crossword puzzle given the jxittern of opern and blocked 
cells, akjng with a tiictionary of words from vvliich to cIkk^sc. Tlie 
dictionary' containc^l up to ten extni words for each word in tlie 
crossword puzzle solution, making multiple stjhiiions w'ere possible. 

The ev^JIu^^rion i.s based on die time ret[uired to solve each of 


Top 20 CotsTESTAJSTS 

I lere are the Top Contestants for the Programmer's 
Challenge, including everyone who lias accumulated more than 
10 points during that the past two years. The riumlK'rs lx:lt>w 
include [Xiinis awardtxl over the 24 most recent contests, 
including points earned by ihis montlTs entnmts. 


sorted diflerently. 1 Lused each puzzle three times iDecause a 

Rank Name 

Points 

Rank Name 

Points 

numfier of eontesuiriCs reported tkii exccuiion time varied 

1. Munter, Erast 

200 

10. Day, Mark 

20 

signific'anLly depending on the son order of the dittionary, a fati 

2. lk>rmg, Randy 

73 “ 

11.Higgins, Charles 

20 

tfwt was lx.)me out in my tests. Some of the entries took two orders 

3, Cooper, Greg 

61 

12.Ilosletter, Mat 

20 

of magnitude more time to solve a [>uzzle for one sort order than 

4. Lewis, Peter 

61 

l3.Stucier, Thomas 

20 

for the same puzzle with a dilTerent sort order. The winning entry^ 

5. Mallett, Jeff 

50 

l4.Gundmm, Eric 

15 

exhibitetl significanlly less variability, ranging from a 4% difference 

6.Nic-olie, Ludovic 

48 

I>.Hart, Alan 

14 

for one crossword puzzle to a 63% difference for another puzzle. 

7*Muq>hy, ACC 

34 

l6.0'Connor, Turlough 14 

Like many of the entries submitted. Mat’s si>liition has a 

8-Gregg, Xan 

28 

17.Picao, Miguel Cruz 

14 

recursive componenl. To accommodate recursion, I gave euHi 

9. Antoniewicz, Andy 

24 



entry* 512K of stack space. 





llie key to efficient st)iution of tliis Challenge was propagating 

Tliero are tliree ways to earn points: (1) scoring in the top 5 
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»f any Challenge, (2) being llic first person to find a bug in a 
published winning solution or, (3) being tlie first person to 
suggest a Cliallenge tliat 1 use. The poinLs you can win are: 

1st place.20 points 3th place.2 jKjints 

2nd place.10 points finding bug.2 po©ints 

3rd place.7 points suggesting Challenge...2 points 

'Itli place.4 points 

Here is .Mai’s winning solution: 

Crossword.c 
© 1997 Mat 
Hosteller 

^define %2 

typedef chai Pu»?.le[kMaxSiie] IkHaxSize] : f referencct! as IxJtyl / 
void CrosswordC 

Pu zzle thePuzzie, t rrtum solved pu/zlt* here 7 

cho r i cr ionary [J . T arniy woiils (o ehixjse trcjiu 7 

1 0 n p u 1G S i E e, /* ntitnlxT of rows/cols in pu?:7k 7 

1 on& d i c L S E ze /* luinilxT of words in dJtiionary 7 

); 

r Pfopnun bejdns I'crc 7 

#iricluiie <ctype*h> 

^include <stdiD.h> 

^include <std1lh»h> 

Ifinciude <strin&.h> 

Mum be ai kasi 3^2 bits, and ideally 32 bits. 7 
lypedef long letter_mai3k_i ; 

typedef gtrur.t I 

const char *original_word: 

unsigned char 1 etter f 11 i P variable siw.d array ofvaiue?^ 11,26]. V 
J Biove_t; 

/• X<in*p<Hiable liaek lo compute size of above struct given how many 

♦ letters it has. It rounds up to sbtcoffv^ ') to guarantee 

* alignment constrainLs arc met 7 

^define KOVELST 7 *E(n) ^ ^ 

((tsizeoftvoid *) ^ M + [slzeof(void ’) U) \ 

/ sizeoftvoid “)) ' 

* sizeof C void t)) 

tfdeflne NEXT MOVElra. n} l(iiove_t •) ((char ■) (m) + (n)J) 

typedef naum I 

aCLEHHSS^UNKNOWH, 

IN^aCLE. 

N0T_IN_CYCLE 

) cyclGnesB_t; 

typedef struct placeinent_t f 
P nuinbef of entries in ‘ move' array 7 
long mnu^Enowen; 

r If this “ cunmi^mark, this placement, t is‘marked'. Wc use 
“ this fur dungs like axiirsive searches 7 
unsigned long janrk: 

P Number of letters in each entry of d»e move' array. 7 
unsigned short lo"Ltecs_per_iaove; 

P byte siitc of each element in the move'array 7 
unsigned shore inove_aiKei 

P Where dtxii this start? 7 
unsigned short start^x* start_y: 

P Direction this heads. 7 
unsigned shun dx, dy: 

P h this paniUon part of a cyclic dependent? 7 
cycleiiGes t in_cycXe; 


/•Totally done with iMs placcmcni? 7 
ehur done: 

p lieJd temporaril)' used during iccursitjn. 7 
long depth: 

p ID index into the board where each letter Is placed. 7 
unsigned long where[kMaxSizeJ; 

P tJthcr placements that interaeci Ibis one. 7 
struct _plocGment t •neighbortkHaxSize + l]; 
p NULLiecminoted. 7 

P arra)' trf variabte-sizc objects! Ron’i ilerefea*nce ilibi array mirmalb', */ 
taove^T •move: 

I plucoment t: 

r No 1 so wc can save room lor NULL at the end. 7 
ffdefine PUCEftENT„STKF,(ti) \ 

(sizeoflplacement_t) + (n) ’ slzeof (niove_t ■)) 

tURT_forJet^tb_l 

static void 

fiiter_roE„leTigth Kplacement^t 'p. 

lettcr^aaskt ‘Xetters_allowed* 
letter.masker *allowed_by_ns) 

I 

mnve t *tii* 'last: 

carts t ■letter_mflsk_t globs l^msak.O = 
lettfits_allowed Ip >whero|0 ]]i 
letlcr_iiiask t ailowed„by^u^i— 
last ^ (Ei 5 ove_t •) £Cchar *) p->ciove + 
tp'>nuiiuiiioves - J) ‘ W0VE_S1SGHU)); 
for - p->movc; in->orlginal word !“ XULLr ) 

^ If £ I Cgiobai_i33ask_0 6 (1 « m->letterlD]} 1J I 
void “copyO - tCvold ••)lflSL)IO]: 
void •r.Qpyl “ ((void ••)last)Il]: 

((void ‘*)ra)[01 - copyO: 

((void [1] = copyl: 

last->origlniil_wcird * NULL: 

-p ’ >nuiiL_inoves: 

last - NEXT^OVEiiafit* HOVF._fiIZE£l)) t 
I n1se I 

allowed„by us 0 1 << m Mel ter [0]; 

m = NEKT_MOVE(ii!. KOVE.SlZEd)); 

1 

i 

ftllowed_by_usLOl ^ allowed_by us 0: 


fjUcf_f<irJcngtb _2 

static void 

fi.lter_for_length_2{placement_t ’p, 

lettec_»ask_t ‘letters allowed, 
leT:ter_Hiask_t ‘allowod.hy vis) 

[ 

iiave_l ‘m, *last: 

coast letter .mask t global_fiiaak_0 = 
letter s_a 11 owed[p->where10]]; 
l€tter_iiiask_t alloved by ue_ 0 ^ 0: 
const letter„mask_t global mask^l ** 
letters_allowed[p >wliereflll: 

Icltcr mask t allowed„by_U^_.l " 
lusi " Cmove.^t *) (Cchar p >ittove + 

(p >nuin_moves ' 1 } * H 0 VK„SIZE£ 2 ) ) ; 
for (ffi = p >tiiovfi; in'>originai_word NUl.L; ) 

if ( ! (global_imsk & & (1 « i3i->lGtter [0])} 

II 1 (giabaljimsk_l b Cl « i:->leiter[l]) 1) t 
void *nopyO “ ((void • *)last)[0]: 
void •copyl ” ((void **)IafiL)[ll; 

((void [0] " copyQ; 

((void *0m)fn “ copyl; 
last >orlgjnal word ” NULL: 

'-p->nuro_movca: 

last - NEXT.HOVEdaat, -MOVE.SIZE £ 2 )): 
j else ( 

allowed_by_na_0 |= 1 << m >letter[0]; 
allowed. by_UB_l [“1 « m >letterrili 
m - NEXT HOVEfni. «0VE_S1ZE(2)) i 
I 

1 

aHQwed_by_us[0j “ allowed by_us_0 : 
allowedly_us[lj = allowed by us 1: 
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fikcT_for_lefigih_3 

static void 

filter_for_lcngth_3{placement_t "p, 

letter_mask_t *letters allovcd* 
letter_mask_t *alloved_by_us) 


) 


iBove_t ’lafit; 

const letter_mask_t globaljoask^O = 
letters_allowed[p- >¥he re [0J]* 
letter_itiask„L aliowed_by_us_& ^ 0: 
const letter„niask_t global mask_l ^ 

letters^alloved fp ^wbereh]]: 
letter_maBk_t allowed ,by _ub_1 ~ 0: 
const iettet mask^t giobaljinask_2 = 
lettera_ 0 llowed[p’>where[2|]: 
letter niiask_^t allqwed_by_^ia_2 * 0: 
last ^ (t»ovo_L •) {(char *) pOmove + 

(p >nua^moves - 1) * M0VK„STZEC3)); 
for (m ^ p->iaovei ni->orig3nal_word 1= NULL: ) 


if { l{global_tnaak^0 4 (1 « m->letter [0])) 

! (g1obal_|flask_l & {1 « mOletter [1] 5) 

I (global_iBask_2 & (1 « iH->leLter[2] j)) 
•copyO * ((void **)lafit}t0]: 

void ‘copyl - ((void **i]ast)[l]; 

((void **)m)[0l = copyOi 
((void *’)m)fl] “ copyl; 
last-^original_wotd = NULL: 

'-p->num_iiiovea: 

Iasi - NMT_MOVE(last. -HOVE STZRC3) ); 

1 else I 

ollowed_by_us_0 - 1 « m->leLLet(0): 
allowed3y^us_l ^ 1 « m >lettetLlJ: 
aliowed_>y us 2 " 1 « m >letter[2h 
m - NEXT^KovK(m* i 

1 


1 


allowed_by_us[Oj = allowed by ua_0 
anowL>d_by_usIll " allowed by_us_l 
allowed_by_usi2l “ allnwed_by^us_2 


t 


l11it'r_lbrJcnRdi 4 

static void 

fntet_for„length_4{placement t 'p, 

letter_masiet ’letters_a1lowed * 
letter_tisask t *a11owed_by_iis) 

move.t *ni, Moat: 

const leticr_mask_t giobal_Dask 0 ^ 
leiLers^allowed[p->wberef0l]: 
letterjuaak^t allowed^by us 0 * D; 
const letter_maEk,.t global_mask_l - 
iettere.ailowedfp >vhcrc[l]J: 
lerter_mask t anowed_by_tis_l ” 0; 
const letter_Biask_t global„inask_2 “ 
letters„allowed lp ’>wberef2l | : 
letter„mask_t aliowed_by^us_2 = 0: 
const l(?ttec_mask_t global tiiaGk_:i 
letter8„allowed[p‘>where [ 5] ]: 
lctter_iiiask_t allowed >y_us_3 0: 

last “ (move t *) ({char '} p-Xraove + 

(p->nuri3 moves 1) * «0VE_SIZEC4)): 
for (m " p >inovc: iii'>orlftinal_word !- mJLL: ) 


if { 


f tglobaI_iaask 0 4 (1 C< m >lettert0j)) 

I (global.mask J tt (1 « m >letterfll)) 

h {1 << in->letterf2n) 

h (1 « mOletteril]))) 

•-)lastj fQ]I 
hast) hi; 


I (global niask_2 

! (global inask„3 

void *copy0 * ({void 

void 'copyl ((void 

((void ^ eopyO: 

((void “ ')iq) 11] “ copyl; 
last'>original_word = NULL: 

-p- >nujB_noves: 

last - NEXT MOVKdaat. -liC}VE„SIZEC4)): 
I else t 

1 « in'>lettGr foj: 

1 C< m->Utter[l]: 

^ 1 « mOletter[ 2 ]: 

“ 1 ti >letter[3J: 

M0VE_SIZEC4)): 


I 


allowed_by^us_0 
allowed_by^us_l 
allowed_by_os_2 
allowed„by_ys_3 
m - NEXT.KOVECm, 


! 


allowed by_us[0] ^ allowed„by_us*0: 


allowed by.u^tl] - allowed_by_us_l: 
ailowed _ by_u s[2] - allowe d_by _os^ 2 : 
allDwed3y„os[^l = aiiowed^by us_3: 


static void 

filter^for lengTh_5[placement„t 'p* 

letter_iiask_t * letters_allowed ^ 
letter_iiask^t *aliowed_by.us) 


move._t ‘m, *iast: 

const letter_iiiask t global_ffliaak_0 ” 
letters allowed[p >where[0]I: 
latter..maak_t allowGd_by_us_0 " 0; 
const letter_mask^t global_mask_l ^ 

1 etters_allowed Ip->where [iH J 
letter_tiiQSk_t allowed_by^ua 1 “ 0 : 
const letter_mask_t global_mask_Z " 
lettershallowed[p->wbcrel2]]: 
letter_mask_t allowed_by_us_2 = 0 ; 
const letter_,iijask_t globai_naBk_3 “ 
letters_aHowed [p->where[3l 1 ; 
letter^inask^t ailawed_by„us_3 “ Oj 
const letter_mask_t global inask_4 ^ 
letters_a 11 owed [p- >vhere [4J j: 
letter_iaask_t all owed_hy_us_4 ” 0 : 
last - (movent *} {(char *) p Move + 
(p->num_!iovGS i) • K0VE,.£IZE(5)): 
for (m - p >move; ]n->origlnal_word !* NULL: ) 


1 (global_iiask..O 
!(global.mask J 
1 (global .irtask„2 
!{gToba1_roflsk_3 
! {gl ob a 1 _itiask_4 
void 'copyO - ((void 
void *copyl = ((void 
void * copy2 “ ( (void 
({void ‘•)m)[0] ^ copyO; 
((void *‘)ci) [1] = copyl: 
{(void *')tn)[2] = copy2: 
last->otlgiiial_word NULL 
-p >tm!i»_iiiaves: 
last - mT_M0VE(last. 

I else I 

ailowed.by us 0 
allowed by_i.is_l 

al lowed_by_us_i 
allowod_by_us_ 3 
a11owcd_by_us_4 


h U Vt tn /letter LOJJJ 
i (I « in >letter[l])) 

4 (1 « iii->letter[2l)) 
fir {1 << tn->letter [3])) 

& {1 « m->lettert4]))) 
*^)last) lOj; 

)lastj [ 2 ] 


M0VK_SIZEC5)}: 


] « Bi >letter]0]: 
1 « ra'>letter[i] i 
1 « »->letter[2]i 
<< m'>lettpr [3lJ 
>lefter[4i; 


1 

1 « 


I 


m ^ NEXT_HOVE(ro* HOVE SrZE{5)): 


I 

allowed_by usfO] = anowed_by..ys_0i 
allowed by.iistl] ^ allowed_by_iis^l: 
ailowed_by_us[2l = ailowed.by us 2; 
allowed_by_ws[3j = ailowed.by us 3; 
allowcd_bj_UHi4j = allowed by us,4; 


t 


filter_fnfjcngih_6 

static void 

filter for,lengLb_ 6 (placement.t *p, 

lei Lor_mask.t *letters.allowed* 

1 cLter_iDask_t 'allowed by.us) 

jiLove_t 'last; 

const letter mask t global^aask.O “ 
lettera.allowed|p >wherelOl1: 
letter.mask_L allowed_by_us_0 “ 0: 
const leiLor_mask_t global.isask 1 “ 
let Lers_allowed [p - >wbe re f 1 ] ] : 
leitei_maEk_t allowed by us_l * 0: 
const letter.maak t globol_aask_2 = 
letters allowed (p >where[2 J J: 
ietter.mask.t allowed_by_us„2 ^ 0: 
const lerter„ffiask_t global.maskw3 " 

1 et t ers_allowedlp->wbere(311: 
letter_mask_t alXowed.by.us 3 “ 0; 
const letter_niask_t global inaok_4 ^ 
letters_allowed fp' >whGrc[4] ] r 
Letter_mafik t allowed_by_us_4 " 0: 
const letter_mask_L global_mask^5 “ 
letters_allowed[p->where[5] 1; 
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lett&r_waj;k t sllowed_by-^us_5 = 0; 
last “ iwov^_t *3 ((char ■) P">iiiove + 

(p )liUtJi_iiioves - l) * H0\rE_SIZE (6)31 
for 
I 


last - KEXT„HOVE(last. MOVE SIZE(7)): 


[n - p->iDOve; fli->origirial word != NOLL: ) 


if ( 


I Cglobfll_iDaskj[) 
! (global_aiask_l 
I (global iaask_2 
I (global. niask_3 
! (global_Ji)ask_4 
! (global_Hiask_5 
“copyO = ((void 
’copy! * ((void 
*copy2 ^ ({void 


& (1 « n >letter[Cll)) 

& (1 « m >letterll])3 
& (1 « m->lettert2])) 

& (I « ]D->Ietteir[33)) 
i {1 « ®’>letter[4])) 

5. [1 « ia->letter[5J)33 
Hast) [0] j 
Jlast)tl]: 

)last)[2]; 


VOli 

void 

void *copy2 
((void **)ii>)t0l ^ copyO: 

((void **)m)ill = copyl; 

((void **)ni)UJ " copy!: 
last->orlginal_word = NOLL; 
-p->nuin_noves: 

last - NEXT.MOVEdast, -M0VE„SIZE(6)): 
I else 1 


all owed s _ 0 

allowed_by_i*G_ I 
all D wed_by_u. s_Z 
aIIoved_by_«s_3 
allowed_by_ua_4 
allo¥ed_by_us_5 
m - NEXT MOVE[a. 


^ 1 « »->iett€r[0l 
= 1 « m'>letter[lj 
- I « a->lott6rt2] 
1 « ni->l€tterf3i 
= 1 << a >letter[4] 
= 1 « m-Mot tot 15] 
H0VE_SIZE£6)); 


3 

ailow(»d_by_us[Oj * allowed by us. 0; 
alIowed3y_ua[lj ” all owed^by^ws H 
allowed_by_usL2] ^ allowod_by_u©_2^ 
allQ¥ed_by_uel3l * ailo¥ed_by_uO J 
flllowed by UBf4l - allowed_by„uS_4T 
alloued_by_Ui[^l “ allowed_by_us_5: 


3 


static void 

f llter.f or_lenftth_7 (place]nent_t * p, 

letter mask t Uetters_allowed, 
lottor^mask t *allowed_by_us) 


rilitT_for_lcngth_7 


t 


move_t 'in* ' last; 

const lettec_iiask_t global_inask _0 ^ 
letters„allowed [p->where[ 0 ] ] i 
lettar_raask_t ailowed_by_us _0 " 0 : 
coTist letter iiiask_t globai_iiiBSk_l = 
letters_sHowed [p->wherell|j: 
letter_Di 0 sk_t allowed by_us_l 0 ; 
const leiier_ino3k„t global mask .2 * 
letters^allowed[p >where[ 2 ] 1 ; 
letter_mask_t ailo¥ed_by_us _2 - 0 ; 
const letter_mask_t global_iiuisk„3 - 
letters.ftllowed[p->where(3] J : 
letter^raask t allowed_by_us_3 ^ 0 : 
consi loTter.jnflsk t global_mask_4 = 
lettcrs_sn owed [p->¥becef4l I * 
ietter_aiask_t allowcd_by,U0_4 ^ 0; 
const ierter^iiask_t global_fflask_5 * 

1 atters_allowed [p - >where (5] ] : 
letter mask t slloved_by_us_3 “ 0: 
const letter mask t global_mask_6 “ 
lGkiers_al lowed [pOwheretb]]; 
letter_iiiask_t alIowed_by us 6 “ 0; 
last = (movent *) ((char •) p->iiiove + 
(p->nom_JBoves - l3 * H0VE_STZE(7)3 I 
for (iB “ p^J'move: m-^original_woi:d !*” HULL; ) 

^ if [ !(global_mask_0 & (1 « m->letter[0]3) 

((global.ransk^l 4 (1 « m->Utter [l] 3) 
!(g]obal_mask 2 
! (global_niask_3 


& (1 « !E->letter[2]3) 

_^ iii->letter[3l)) 

! (global_iuask_4 i (I m->lettert4])) 

Kgiobal_inasi^5 h (1 la-^letter [5])) 

4 (i << ID Metier [6]))) I 

*)last3[0]: 


!(global_mask_6 
void •copyO ^ ((void 
vnld ’copyI “ ((void * *)la&t) Uit 
void ^copy2 ^ ((void **)last)L2j: 
((void '•)m3l0] ” copyO: 

((void **)in3tli " copyl; 

((void ’*)ii3i2] ^ copy2; 
last->otigiiial_word * NULL: 
-p->Tiim_aoves: 


else ( 

allo¥ed_by_us_0 
allowed by,us_l 
al1owed3y ijs_2 
allowed_by_u s_1 
al1owed_by_us_4 
ail o¥ed„b y_u e_ 3 
a11owed_by_us^6 
m - NEXT_M0VE(m* 


- 1 « tn >letter [0] : 
= 1 << [n->letter [1] ; 

- 1 << 10’Hetter [2]; 
= 1 « m->letteri3j: 

- J « m‘>letterUJ: 

- I « mMletter [5]: 

- 1 « B >letter [6]; 
HOVE_SlZEt7)3: 


1 


allowed_by„ns[O] 
allowed_by«.us [1] 
allo¥ed_by..us[2] 
allowod_by_'iisi3j 
allowed_by_usi4l 
allowed_by_ns[51 
allowed_by_us[6J 


aUowed_by_us_0; 
allowed_by_ue-lJ 
allowed3y_u^_2: 
aXlowed_by-^^fl-3; 
allowed_by_us_4: 
a11 0 wed_by_us^5j 
allowed_b y_u s_6: 


filtCT^fuT_lcngtbJ8 


static void 

filter £or_length_SCplacement„t 'p* 

1etter.mask t *letters_allowed» 
let te r_m3 sk. t * e 11 owed_b y_ii s) 


\ 


move_t Mast; 
const Utter_inask_t giobalj»ask_0 
letters_allo¥edLp'>wbere[0]|: 
letter .mask_t allowed„by-us_0 0: 
const letTer mask_t global_Hask_l " 
letcers_allowed fp*>where[lj J: 
letter_nask_t allowed^by.1 = 0: 
const lettet_iiiask_t global_iBask. 2 “ 
letter shallowed tp >¥liGre [2 ]); 
letter..ffiask_t alioweil_by_us_2 » 0; 
const iette£_ii!ask_t giobal_iBasle3 * 
letters allowed[p'>where [31] ; 
lcMter_inask_t allowed_by_uE_3 = 0: 
const lGtter_iEiask_t glabal_inask„4 “ 
lettershallowed[p >wbere[4l]: 
letter_aask_t ailowed_by_us_4 ” 0: 
const letter_mask_t giobal„ii»sk_5 - 
letters^allowed Ip - >wliere [5 j ]; 
leiter_mask_t allowed_by_us_5 “ 0; 
const lett€r_iiask,t global_aiask„6 “ 

lettGrs_anoved [pMwbete[6l ]: 
ietter_inBBk_t allowcd_by._nfl_6 = 0: 
const letter_mask_t global_mask_7 = 
lotters_aliowed1p->where[7]1: 
letter_mask_t ailowed3y-Vis_7 = 0: 
last - (move.t *) {(char *) p-Move + 

(p ->nuiii„moves - l3 * MOVERS IZE (8)) ; 
fot (m p >niove; m->original_word != NULL; ) 


I 


if t 


!Cglobal^mask^O 
! £giDbal_maak_l 
I(global_Bask_2 
I(global_mask_3 
I(global mask_4 
!(global^nask S 
! (global„inask_6 
1(giobai_mask^7 
void ’copyO = ((void 

void ’copyl * ((void 

void *copy2 - ((void **)last3[2]; 

((void ”)a) [0T * copyO; 

((void ’Mm) hi ” copyl: 

((void ’Mm) [2] " copyl: 
laat->original_word ® NULL; 
“P‘>nunL_moves: 

last - NEXT_MOVEtlast. HOVE^STZKS)); 
I else ( 


(1 « m'>letter[0])) 

h mMletter[1])) 

(1 « in->letter[2l)) 

(1 CC m >lctteri3i)) 

U « ni'>letter[4]3) 

(1 « m-Matter [5] 3 ) 

(I <( mMletterUJ}) 

(1 <C m->l 0 tter[7]))) f 
)lasO[0l: 

Jiasl) [1] I 


allowed by_us 0 
al 1 owed_by_u 1 
ail owed_by „us_2 
a 1 lowed_by„us_3 
all owe d_by_iis_4 
all ewe d_by_u s„5 
a1lowe d_by_us_6 
allowed by.us_7 
m - NEXT_HOVECra, 


" 1 « m-)letter[0]: 

- 1 « mMletterEli: 

- 1 « «‘>leT:ter[Zj: 

- 1 « m->letter[3]; 
= 1 « m->letter(4l: 
= 1 « m >letter [5]: 
^ 1 << m >lettert6l : 

- 1 << mMletter [7]: 
MOVE„SIZEte)3; 
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I 


anowed3y_us [Oj 
alloiifed_by_ua [1] 
£illowed_by_ufi [2] 
allowed_by_us [3] 
al X o'wed^y-ua f 4 j 
alloved by_us[5j 
aHowed3y_us [6] 
allowed^by^us [/] 


= alJ.cived_by_us„0: 

allowed_by_ufi_I; 
“ allowed by ufi_2: 
“ a 1 lowed _by_ti s_3 : 
^ all owed _by_us_4; 
“ allowed_by_ti5j5; 
= allowed_by_yfi_b^ 
* allowed_by_us_7: 


filterJbfJcngilu9 

siaiic void 

filter_for lGngtb_9Cpleco[iK!nL_t ‘p, 

letter_mask_t *letters__aliowed* 
lettor_iiiask_t *allowed_by„u3) 

I 

raovo_l *nu ‘last; 

const Ietter_jna&k„t global maEk 0 = 
ietters_allowed fpOwherafOl): 
lette!:_iDaflk_t aUowod_by_us_0 * 0i 
const letrer_iimsk_t giobal_tBaek_l - 
let to rs_al lowed [pOwbere [IJ J: 
lettcr„Bafik_t allowe<l_by_iis_l = Oj 
const letter_iiiask_t global_iiaBk„2 = 
letters_allowed fp->vbecef2] 1 1 
letter_®ask_t allowed_by_UB_2 0: 
const letter iaask_t global_aiask_3 = 
letterfi_a1lowed[p >where[3]j i 
letter„mask^t allowed^by^us^S ^ 0: 
const leiier_raask_t globaX_®aak_4 
ietters„ailowed [p->wheref4i]; 
letter_ioask_t allowed_by_us 4 = 
const letter_maEk t global_]iiask_5 = 
letters_allowed[p >whGre[S]J; 
letter_Eiask_t allowed„by_us_3 = O r 
const lcUer_mafik_t global_niask_& ^ 
lctters^aliowedtp->vberei6] 1: 
letteir_mask_t allowed_by_uE 6 ^ Or 
const ietter^mask t global iiiask_7 
letters allowedIp->wbcro[7]]r 
letter in3sk_t allowed_by_os_/ “ 0: 
const lettcr_mask_t global_TEask_8 “ 
le 11 e rB_allowed ip - >whe re [ S] 1 r 
letter_rassk_t allowed3y_os_8 * 0; 
last ^ (t!iove_t *) Cfchar *) p'>jitove + 

(pOnum moves - U * MOVE^SIZE(f)): 
for (jn “ p*>!nove: »b >orlginal„word != NOUir J 
I 


If ( 


voi^ 

void 

void 


1 (global_®ask_0 
f (globai_niask_l 
r ^global_mask_^ 
1(global mask 3 
! (gIobal_Buisk_4 
! (globa!_inask_5 
! C globai_Hiask_6 
I Cglobal_jiiask_7 
ICglobal jBafik_0 
•copyO {(void 
•copyl - {{void 
*copy2 - ((void 


void *copy3 “ ((void 


& (1 << ro->letter[0]) > 

& (1 « ffi->lettertl])) 

^ {1 « ii!->letter [2])) 

& (I « w >lotter[3]i) 

4 (I « m >letter[4n) 
h (I « ]ii->letter [5] i) 

& (1 i< E->letter[61)J 
6 (1 << iB‘>letter [7])) 

& (1 « tfi->letter[ej)i) 
••Uastiroli 

-nasUf2]r 
jlast)[3j r 


copy3 

(fvofd * *jm)[Q] ^ copyO 
((void ‘*)ra) [1] “ copylr 
((void *' )tn) [2j * copy2: 

((void [3l “ copylr 

iast’>original.word NULL; 

--p‘>nm.moves; 

last - NEXT KO?E(lasl. l10Vli_SlZE(3)): 
1 else I 


ollowed3y_us_0 
ellowed_by_us_l 
ailowed_by_ua_2 
allowed_by_Ufi_3 
allowed.by us 4 
ailowed_by_us_5 
allowed„by_us_6 
allowed_hy_u5_/ 
allowed_by^us_& 
a - NEXT_H0VI(m, 


J 

1 

allowed_by usfO] 

allowed_by_us[1] 

allowed_by_Ui"[2l 

allowcd_by_us[3i 


^ I << m-yiettec[0]T 
1 << m-^yietter [1 j; 
“ I « iB‘>letter [7.]: 
= 1 << ti->letteri3]; 
" I « ti >letter[4]; 
" I B-^letter; 
" 1 « m->letterl6j: 
= 1 « Hi->letter[7]: 
“ 1 « in'>letter [8]; 
H0VE_SrZE(9)): 


“ anowed_by_u3_0; 

ollowBd„by_us J : 
= allowed_by_us_2: 
= allgwed_by_us 3: 


allowed_by_us[4] 
allowed_by_uE[5] 
Eliowed_fay_ns[fi] 
allowed_by us[7] 
ellowed_by_us[8] 


= allowed_by*.ua_4; 
” allowed by us_5; 
“ allowed_by_us_6: 
= allowed_by_u s_ 7; 
“ allowed3y^cis_8: 


flJiaLforJcttgtlj_J0 

static void 

filter_for_leiigth_lO(placement t 'p* 
letter_iiflsk„t ‘letters^allowcd, 
letter_iiask_t *allowed_by_tts) 


fBOVO_i ’in, *lastr 

const letter_ntask_t global_misk_0 “ 
Ietters_allowed[p->wh6refon : 
letter_iiiask_t allowed^by us 0 “ 0: 
const letter inask.t global_fiiaak„l " 
letters all owed[p * >whcrf[1j]; 
letter_iaask_L allowed_by_us_l = 0; 
const lettei:_inask_t global_niask_2 - 
letters_ailowed[p’>where[2l 1; 
letter_iiiask_t aliowed_by_UB_2 - 0; 
const ietter_mask„t global niask„3 “ 
letters allowed[p->wbere[1]]; 
letter !iiaKk_t al lowcd_by_tis_3 “ 0; 
const letter_wask_t global_oiask_4 = 
leiters_allovedip->where[4j J: 
letter^piask^t aiiowed_by_iis_4 “ 0: 
const letter_nask_t global mask 5 “ 
letters_allowedrp->whflre[5l]: 
letter_n!ask_t allowed_by_ns_5 " 0; 
const let±er_inask_t global_iiiask_6 “ 
letters_allowed[p->where[6]1; 
letter_mask^t allowed_by_u8_6 - Or 
const letter_mask_t global mask 7 ' 
ietters_aliowed[p->wbere[7l|; 
letter_siaEk_t allowed by ub_7 * 0; 
const letter_toask_t globoLmask^B 
letters_allowed[p )where[8jjr 
lor i;or_tiiask_t allowed_by_ug_8 “ 0; 
const letter_iaask_t global_Tnask 9 - 
letters^allowed Ip->wheref9l ] : 
letter_inask_t allowed by us_9 - 0; 
last “ [iiiove_t •) ((char ") p >BJOve + 
{p->mm_tnqye3 1) * H0VE_SIZ£( 103): 
for (m = p >iicve: m->originai„word I* NULLr ] 


if ( S(global_raask_0 4 
!(global mask J & 

I(global mask 2 8 
1 (global_mask„3 £r 
1(global_mask_4 6 
1 (global_Hiask_5 & 

IEglobal_mask_6 6 
f (global_Eiask_7 & 
rCglobal mask S h 
Kglobal mask 9 h 
void *copy0 “ ((void 

void *copyl - ((void 

void *copy2 = ((void **)iasr)[2j: 

void ‘copy! = ((void **)Xast}r3l: 


(I « in->letter[0j)} 

(1 « ifi >]eiicrtJ])) 

(1 « JE >lcLtet{2]3) 
(X << m >letterl3j3) 
(1 « m->Xetter[4l)) 
(1 « m->letter[5])3 
(1 « in->letter f6l)) 
(3 « tn->letter [7])) 
(1 « 11 >lettcrl8J3J 
(t « ti >letter 193)3) 
)Usl)tO]r 
)last){l]: 


([void **)m)[0j - copyO; 

((void “)ni) (11 - copyl; 

((void = copy2: 

((void “)mU3] “ copyl: 
laflt->or1ginal_word = NULL; 

-p->num_moves: 

last = NKXT_KOV£(last* -H0¥E_SI2E{10))r 


1 


else I 

alXo¥ed_by^us.^O 
allowed_by_us. 1 
allowed by ua_2 
all owed_by_ns_3 
al lowcd_by_us_4 
allowed„by_uB_5 
allowed_by_us_6 
allowed_by_e£^7 
ailowed_by_uB 8 
allowed by us 9 
m = NEXT_MOVH(m* 


“ 1 << m >lertert03 i 
^ 1 « in >lottcr ll]; 
*= I C< n yiettertzj; 
= 1 « in yietterilj: 
= X « m‘>letterl4]: 
= 1 « B->letter(5l: 
- 1 « m->letter[6]: 
* 1 « m">letter[7]» 
^ 1 « »>letler[8]: 
= i << m >letter(9i r 
«0VE_S1Z£(10)); 


1 


I 

allowed_by_osiOj “ allowed_by,us 0; 
ailowed_by_UB[1] - allowed by us t; 
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alloved_by_us L3 J 
flllowed_by_^s [3j 
allovad by_us[4j 
allowed_b y_ us[5] 

allowi?d_by_^^ [6] 
ailowed_by_iis [7] 
allowed_by_us[8] 
alloweOy_ua L9J 


= allowed_byjs_2 
' ailaved_by_^e_3 
“ ail owed_by_u8_4 
“ allowed_by_us_5 
= allowed by_ufi_6 
” a11owed_by us? 
= all owed _by_Ui3 B 
= allowed_by_us_^ 


fUtcr_fbr_lefigth_t 1 

static void 

filter_for„leD^tb_lI(placement t *p* 
ietter_mask_t ^ lctlccs_anowed ♦ 
letter_ 0 iask_t *aliowed_by_us) 
t 


move t *m. ’last; 

const letter m&Mk_t alobai_mask_0 = 
lottors_a1lowed fp->where[D]]: 
letter_mask„t allowed_by_UH 0=0: 
const letter_roasK_i global^maak^1 = 
lettecs_allowed[p ^wbere fIJ]: 
letter_ffiask_t alioved_by_us_l ^ 0^ 
const letter_mask^t giobal_mask_Z - 
letters allowed[p->tfhereL2JJ ; 
lottor_iaaek_t allowed by ua_2 - 0: 
const letter_Riask„t global mask 3 = 
letters_alIoued[p >wliere[3l] ; 
letter_msk_i: allowed_by_uO * Oi 
const letter_iiask_t global_aiask_4 " 
letters_allowed lp->wbera [41] ; 
letter_aiaak t alloved3y-*ua_4 = 0: 
const lcttor_nask t global ,mask_5 
letters_allowed[p->whRre[511; 
letter„iiiask„t ailowed_by„us_1 " 0; 
const letter_mask„t global_tnask_6 “ 
letters_ailowed[p->wbere[6]]; 
letter rasek.t allowed_by_UB_6 = Oi 
const letter mask t global_fflask_7 = 
lc!itors_allovedrp')wheret7l ] : 
letter^maak^L allowcd_by. us 7=0: 
const lerter„mask_t global„mask_8 = 
letters_ailowed[p->where[S]J : 
letter_Eask_t aiiowed_by_us_8 = 0: 
const letter_iiiask_t global_mask_9 = 
letters allowed Ip->vheret9J 1: 
letlcr_iaask_t allowed by us, 9 “ 0: 
const letter_mask_t global mask 10 = 
letters„allowed [p >where[lO)]j 
l€tter_oask_t allowed„by_UB„l0 = 0; 
last ^ (mcive_t {(char *) p >niovc + 
Cp->num_nioves ■ 1) * H0VE_S1ZEC11) }; 
for (jti pOmove: m->original_voi:d != fJLiLL; ) 


if ( 


!(global^mask 0 
J {glDbal_(imsk_l 
! Cgiobal_iiiask_2 
! {giobai_iiiask_3 
1 Cglobal_)iiaEk_4 
! (global iiiask_5 
1 (global mask 6 
I(global^mask 7 
[ (global_mask_8 
[(global_mask_9 


(1 i< m->letterLO])) 
(1 CC mOletterfll)) 
ni->Ietter [2])) 
ot Hotter [3])) 
m->lcltor[4])1 
lE'Metter (5))) 
(1 « m->ietter[bj)) 
(1 « m‘>letter[7])) 
(I « in‘>Ietter[81)] 
(I « m->letterf9n) 


Cl « 
tl « 
(1 « 
Cl « 


! (giobai_iiiask_10 & (1 << nt >letter [10]))) 
void 'copyO ^ ((void •*)iast)[0]; 
void *copyl = ((void **)iast)llj 
void *copy2 = ((void •*)last)[2] 
void *copv3 * ((void •*)last)[3l: 

((void [0l ^ copyO; 

((void **)hi)[ 1] ^ copy!: 

((void *Hm)[2j “ copy2; 

((void •’ltQ)i3i = copy3: 
last’3original_vord “ NULL; 

-p*>num_ranves: 

Iasi " NKXT_KOVE(laSt* -H0VE_SIZE(11)): 
i else I 

I <C 

1 « 


ailowed_by_u3_0 
ailowed^by„U3^1 
alloved_by_u3_2 
alloMed_by_us_3 
allowed by us_4 
allowed_by_u s _ S 
all owed^by s_6 
ailowed_by_Us_7 


>letter[0] 
>letter[lj 
1 << a >leLlert2| 
I Ki, a-yiettett3l 
1 « m'>ietter[4i 
1 a a->letterL5j 
I « a'>letter[6] 
1 << a->letter[7l 


I 


allowed_by_us_8 !■ 1 « iD->letter[8j; 
allowed_by_us_9 ] « m-Hetter [9] ; 
allowed„by_us_]D |* I « m->letter [lOl ; 
m = NEXT^HOVK (m, H0VE_SIZK (ID): 

I 

1 

allowed„by uslO] “= allowed_by_us_0: 
allowed_by_ua[1] "allowed_by_us_1: 
allowed_by_us[2] - allowed by_iis_2: 
aliowed_by_us[3] = allowed_by us .3; 

&11 owed_by_us [ 4 ] ” all owed_by_y3 _4; 
allowed_by_us [5j = allowed_by_ii3_5: 
allowed by_usl6l * aliowed_by_us_bt 
allowed_by us[7] - allowed_by_us_7; 
alIowcd_by_uats1 " ellowed_by_us_8; 
aliowed_by_usl9] ^ allowed by us_9; 
allowed3y_us[10l ” a]lowed_by us 10; 

I 


riltet_fiir_length_l 2 

slatic void 

filter„£or_lcngtb_l2(placement_t *p, 
ietter_aask_i ’letters allowed, 
ietter_Biask_L *al 1 owed3y^us) 

move t 'm, ‘last; 

const letter_mask_t giobal_mask^0 = 
letters allowed [pOwberetOl] ; 
lettet_mask_t allowed by us_0 * 0; 
const lt'LLGr_mask_t global mask„l = 
ietters_allowcd[p >vbere[lll: 
letter_inask_t allowed3y^us_l • 0; 
const letteF_mask_t globul_iiiask_2 - 
lBtters_allowed [p* >where [2] J ; 
letter^mask t alloved_by_us_2 “ 0; 
const letter_raask_t globsl_aiask_5 - 
letter£_allowed [p->wbere [3ll; 
ietter_raask_t allowed3y_LJS_3 = 0; 
const letter_iiiask_t globs l_mask_4 " 
letters_ailowed(p’>where[4]]; 
letter mask t alIowed_by_us_4 = 0: 
const 1 erter_iiiaBk t global„[nask3 ^ 
lettcrs_allowed [p->wbere[5] 1; 
ietter_ii]ask_i allowed^by us 5 = 0; 
const letter_mask^J. global.mask 6 = 
latters_ailowed [p >where [6] 1; 
letter mask^t allowed3y_ns_b = 0: 
const letter_mask_t globaljmsk_7 = 
letters allowed[p‘>where [7J J: 
lettec_iE 06 k_t allowpd.by us 7 “ 0: 
const letter_iiiask_t global mask 8 = 
letters_allowGd[p >whRre[B]l; 
letter_iiia3k_t allowed3y-.us3 D; 
const lett6r_mask_t global_iiiaak_9 - 
letters .allowed|p->wbere[9]J : 
lcuer_magk_t aUDwed_by_us3'0: 
const leiier_»pask_t global iaask_l0 " 
ietters_allowed [p'>wheref 10] ]; 
letter_niask_t allowed3y_uO(l “ 0; 
const letter_iiiask_t global_iiiask_l 1 " 
lettershallowed[p'>where[ll] ] ; 
letter^mask t allowed_by_us_ll = 0: 

IflEl ” (move t *) C (char *) p->aove + 

{p >nujii_iHoves ’ IJ ^ HQVB_SrZlCl2)): 
for (m * p >niove; jn->original word != NULL; ) 

[ 


if ( ! (global_masK_0 (f (1 << 

!Cglobai^maak^l fr (1 << 

! {global_i!iask^2 & (1 « 

1[global_«ask_3 & (1 « 
f (global^mask 4 ^ (1 « 
r(global_mssk 5 i (1 « 
r [globsl_mssk_6 4 (1 << 

(Cglobal_inesk^7 4 (1 

1[global_mask_S t [1 << 

I [global_Eask^9 8(1^^ 

1 (global_tnask_10 & (1 « 
t(global mask.11 & (1 « 
void ‘copyO “ ((void •Hlast) 
void tcopyl ^ ({void “)last) 
void 'copy2 ({void '‘)last) 
void *copy3 = ((void ’‘Hast) 
({void **)m)L0j “ copyO: 
((void **)m)[l] = copyl; 
((void **iin)f2i « copy2; 


m>lettet[01)) 
ffi >lGtter[1])J 
m->letter[2])) 
it*>ietter [3j)) 
O’kietter[4]}) 
m“>letter[5j)) 
(n^letter [6])) 
iii->letter [7]}) 
m->letter [8])) 
m >letter[9])i 
ra'>letter [10])) 
til->letter [11]))) 

fOl i 
fil; 

[ 21 : 

DJ: 


March 1998 • MacTech 


Programmer's Cjiallunge 


59 



















\ 


({void **)in)[3] = copy3; 
last >oclslnal_word = NtTLL: 

-p'>n\im_fliove8; 

last * KEXT^MOVEdast, -HOVE SiZEiIZ)): 


) else ( 
all 0 wed_by_u e_0 
a n owed_by_ue_l 
al lowed_by_ua_2 
al 1 owed_by_us_3 
al lowed_by-^ua_4 
al lowed_by_UB_5 
allowed_by 
allowed_by_Ufi_7 
all owed Jb y_u s_S 
alio wed _by _9 

all 0 wed_,by_u3_ 10 
all 0 we d„by_us_ 11 
in - NEXT_HOVE(jn. 
I 


“ 1 iQ >letl;er [G] ; 

= I << m->letter[1]: 

= 1 « jii->letter[2] r 

= 1 « B!->letter[3l j 

“ 1 << m-> letter [4]; 

“ 1 << iii->letter [51; 

= 1 << inletter[6]; 

" 1 C( m >letterd] ; 

“ 1 « m->letter[s]; 

“ 1 « ni'>letter [9J ; 

= 1 C< in->letter[10l I 
“ 1 (< in->letter fill j 
H0VE_SIZE(12)); 


} 

allowed. 

allowed. 

allowed. 

allowed. 

allowed. 

allowed 

allowed 

allowed. 

allowed. 

allowed. 

allowed. 

allowed. 


.by_us[0j ’ 
_by_us[ll ■ 
-by^usizl ^ 
.by_us[3j ' 
_by_us[4l ■ 
_by_uE[5j = 
.by^ustb] ’ 
_by_a8(7] = 
_by_iis Is] = 
_by_uB t9j “ 
>y_tistlOl 
.by_usfu| 


* allowed_by_iia_Oi 

* ailowed„by_iis_l; 

^ allowed__by_tis_2; 

‘ allo¥ed_by_ufi_3j 
■ allowed by_uB_4; 

* all owed_by_u s_5; 

* allowed_by_us_6; 

* allowed_by_uE_7: 

* allowed_by_us_&: 

‘ alloved_by_os_9: 

allowed.by us.^10; 
” allowed by_us_11 1 


filter, for Icn^tii. 13 

static void 

filtei:_for_length_13 CplaceiDent_t *p, 
letter_siask_t 'letters allowed, 

^ letter, mask^t ‘anowed_by_as) 

move_t *ra, ‘lasti 

const letter_inask_t global_iiask_0 “ 
letters_allovedtp’^where[Ol1: 
letter^ask_t allowed_by_us_0 ^ 0; 
const lettet^mask t global_diask_l * 
letters^allowedIp->where[l]]; 
letter_(nask_t allowed_by_us_l = 0: 
const lGtter_tiiask_t global^mask^Z ^ 
letters_ailowed[p">whGref2]]: 
letter_mask_t allowed_by_us Z ^ 0: 
const letter_mask_t global mask 3 = 
letters.allowed(p^>whete[3]]: 
letter. Biask_t allowed_by_us_3 - 0i 
const ]etter_niask_t global_mask_4 = 

1c 11 c rs_a1lowed[p ^ >whe re[4 j J: 
letter^mask^t allowed_by_us_4 0: 
const letter_iiiaek_t global mask 5 = 
letters_allo¥ed [p ->where f 5 J]: 
letter_iaaBk_t allowed by ijs_5 *= 0: 
const Utter iiiask_t global_i&ask_6 " 

Uttfirs^allowedlp >where[6j] : 

1 et tet_tiiask_t allDWed_by^Us_6 ^ 0; 
const letter_inesk_t global_mask_7 
ietters^ailowed Ip->wheref7] 1 : 
letter_jiiask„t allowed_by_uH 7 = 0; 
const letter mask t global_jnask_8 " 
letters.allowed[p->whcre tfi] ]; 
letter_ii3ask_t anowed„by_ue_8 = 0: 
const UlLer_aiask_t global_niask_9 “ 
letters_allowedtp*>wbere[9ll: 
letter_ 0 iasJet allowed.by^us 9 = 0; 
const letter_niask t globaLmask 10 ^ 
letters.allowed[p->wheret lOjj : 
letter.mask^t allowed_by_us_l0 * 0; 
const letier_»ask_t global_iEia£k_ll = 
letters_allowed [p->vhere [llj J ^ 
letter_niask_t aIlowed_by-.us_U “ 0; 
const letterjia8k_t global.mask .12 = 
letters_allowed fp->wbere[12]): 
letter_raask_t allowed_by_us_l3 " 0; 
last ^ (movent ((char *) p >fflave + 

(p >nuiii_aKjves 1) * H0V£_£1ZE(13)): 
for (m = p >move: (D->originai_word HULL: > 

if ( ! (global_lflask_0 & (1 << in->Letter[;0])) 


! (gl obal_mask_l 
! C global_siaak_2 


! (gIobal_aaek .5 
J (global B)ask_6 
J {glob3l_inask_7 


(1 C< Di->Utte£ll])) 

. ^ (1 iii->letterl2])) 

!(global_ma3k_3 4 (1 « a->lettecl3l)) 

! (global_mask_4 & (1 « in’>lettet f4|)) 

(1 m-^letter [5] 1) 

(1 « m >leiler[6l)} 

. u (1 « ffl >lettec[/l)) 

t (global_iDflsk_& 4f (1 << m->letter IB])} 

I (global_J!iask_9 6 (I << m->letter [9J)) 

I (global_mask_i0 & (I C< ai->lettec lioj)) 

I (global_mask_ll 5 (1 « a->letter [111}) 
!iglohal_mask_l2 S (1 « m->letter(12]))) I 
‘copyO = ((void *“)]ast)[0]; 
void 'copy! = ((void *“)Ust)ti] 

void ’copyl ” ((void **)lsst)[2] 

void "copy! ^ ((void **jlast)(3j 

void *copy4 = [(void *‘Jlast)i4]j 

{(void **)m)1.0j * copyG: 

((void **)iit)[l] - cojsyl: 

((void **)ni)[2] “ copy2: 

( {void '•)ni) [3] “ copy3: 

({void "}iit)[4] = copy4: 
last ^orlgiiial_wDrd * NULL: 

-p->mua_rooves: 

last = Nm_HOVE(last. -HOVE SIZE(13}): 

1 else ( 

I << m >lciter[0] ; 

1 « m >letter[lj 
1 << ta->letterl2j 
1 << ni'>Utter[3l 
I <C in->Utter (41 
1 << m->lfitter(5l 

1 << m->letter[6] 

I <C m >lctLer(7] 

1 C< mOletteria] 

1 « ni->letter[91 i 
- 1 << io->ietter(101 1 
I C< ti->letter fill: 

1 « iti->letter[| 2); 


allowed_b y_us_ 0 
a 11 owed_by_iis_l 
all owed_b y _us_2 
allowed_by_us_3 
ailowed_by_us_4 
all 0 wed_by_us_ 5 
allowed_hy iis b 
a n owed. by_us_7 
allowed„by_us_8 
allowed_b y_us_9 
al1owed_by_u s_lC 
a1iowed„by_us_l1 
a1lowed_by_us_l2 


I 


m “ NEXT M0VE(m. MOVE .SIZE(]3) 1 : 


I 


aliowed_by_us[0] 
al1q we4_by_us(1J 
allowed_by_us[2] 
allowed_by_iis(3] 
allowed„hy_os (4] 
allDwed_by_us [5] 
allowGd_by_iis [ft] 
allowed3y_us [7] 
a11owed_by_usi61 
allowed3y^iis f9] 


al 1 owed 3y_ti s_0 
ailowed_by_ufi_l 
allowed.by us 2 
allowed. by_Lis_3 
all owed _by_us_4 
allowcd^by-i^O 
all owed _by_ns_6 
a|iowed_by_ua_7 
ailo¥ed_by_us_8 
allowed .by us 9 


allo¥ed_by us(10] = allowed_by„ufl_i0: 
allowed by usfll] = aH0¥ed3y_us„n : 
a 11 owed_by_U!S [ 12] all owcd_by_us_l 2 1 


static void 

filter_for_lengtb_ 14 (placement t *p> 
letter mask r * 1erters^a11 owed » 
1 et t e r_ina sk_l ‘all owe d _by_u a) 

I 

Diove_t ‘m, ‘last: 

const ietter_ma6k_t global_maEk_0 » 
ietters_allowed fp->vhere[Oil: 
letter_!Qask_t allowed by ns .0 * 0: 
const letter .aaak_t glol5al_mask_l 
letterB_al]owcd[p >whcrc[l]l: 
lettGr_iiiask_t allDwed_by_us_l * 0; 
const letter_mask_t global_fflask_2 - 
Utters_aiIo¥ed(p->¥here(2| 1: 
ietter_mask_t allowed_by^us_2 * 0: 
const letter_inask t global _aiask_3 " 
letters_allowed[p->whcrol3] ]; 
letter_ftiask_t allowcd_by_us_3 = 0; 
const letLet_iiiask_t global_mask_4 “ 
letters_allowed ip->where[4] i: 
ietter_iiiaak_t aliowed_by_us_4 - 0: 
const letter^mssk^t global.mask 5 ^ 
letters_allowed \ p->where f 5]]: 
lettBr_mask_t 3Xlo¥ed_by_US_5 “ 0: 
const 1etter_inask_t global_nia3k_6 - 
letterK_allQWGd[p■>where(6 J1; 
letter_iiiask_t allowed_by„us_6 = Oj 


liltcr.fbr.lcngth. 14 
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Eltcr_for_lcnj^_l 5 


1 


const lettcr_mask_t global_ffiflsk_/ = 
ietters^allowedLp-^vherel7]j; 
letter_raask_t aUoweOy^us_7 " 0: 
const letter..iEask_t globaJ._mask„8 “ 
letters allovedfp’>wherefS]] : 
letter_iiiaak_t al Inwed3y-W3_B 0: 
const loLtcr^ask^t globei_iiiask_9 ^ 
lettets_ellowed[p >whei:e{9)] * 
J.etter„mask_t allowed_by_tifi_9 “ 0: 
const lettec_inask_t giobaLmask.lO ^ 
lettera_allowed [p->vhere flOl ] : 
letter mask t allowed by ns 10 ” U; 

CO nst 1 etrte r _m sk_t g\ oba 1 _nia ok_ 1J = 
letters_allowedtp >where[lllli 
letter_BiaBK_t allowed_by_us_ll “ Oj 
const letter_iiiask_t gIobai_iDask„lZ = 
iette rs_ailowed Ip ->whe re L12 J J: 
letter_iiiask,.t ailowed_by_ns_12 " Oi 
const letter mask t global mask 11 " 
letters_a1 lowed [p->wber0tl3n I 
lcLLer_iiask_t nllowod_by_us_13 * 0: 
last " ttaove_t *) ((char •) p->move + 

(p->nijm_ttoves - 1) ' M0VE_,SIZE(14)): 
for (m = p->fflove; m'>originai_WQrd !- NllLL; ) 


if ( 


t(global mask 0 
I (globa1_in3sk_l 
t(giobal_mask^2 
!(global_mask_l 
!(global_iflask_4 
I (global_Pia£k_5 
!(global_mask_6 
r(global mask 7 
t(g1obal_mask_fl 
!(global„mask_9 


(1 << m->letter[0l 3) 
ft (1 « m->letter f 1] 3) 

6, (1 « m >leuert2])) 

h (1 « m->lettBi:[3])) 

& (1 « ni->lettert4j)) 

& {1 « m->letter[SJ)) 

& (1 « m->lettei:[6l)) 

ft (1 « m->letter [7])) 

5i U « m->lotter[ei)) 

U 


(1 « m >lctter[9]3) 

! (global_mask;_10 & (1 << m->letter [10]) J 
! (global_Biask_ll i (1 « p->letter 111))) 

! (global jnask_l 2 & [1 « m-Metter llll)) 

! (global mask .B & (1 « m->lettetfill))) 
void 'copyfl " ((void '*31ast3 [0] J 

void *copyl “ ({void ‘*)]ast)[ll; 

void 'copy2 * ((void **)last)[2]; 

void *copy3 " ((void '•)last)L3]; 

void *copy4 • ({void **lla£t)[4]: 

({void ’'JttllDl ^ copyO: 

({void "3ni}ril ” copyl; 

{(void *•)»!») [2] ” copy?.: 

((void [ll ^ copy3: 

((void *Mm) [4i - copy4; 
laat->original„¥ord = NOLL; 

-pOnum^moves: 

last - NEXT MOVECiast. -HOVE SIZE(IA)); 

1 else I 

« m >lctter[0]; 
i « m >letter|l]: 

1 << Tn->letter|2i : 

1 « Eft'>Ietterl3]: 

1 << mOlettet [4]; 

1 « m->leti:er[5l: 

1 « m'>letter[6]: 

1 « m >letlerl7]; 

1 « in->letter[S] ■ 

« ni->letter [9]: 

“ 1 C< m-HetterflO]: 

■ 1 « m'>letter[ll]; 

1 « m->letter[12]; 

t « m >letter[13}: 


a n o we d _by _ w SJO 
allowcd_by_n5J_l 

allowed_by_US_2 
allowed_by_us_3 
ailowed_by-.tifi^4 
allo¥ed_by_us_5 
allowed by us 6 
at 1owed_by_us_7 
al1 0 wed_by-Us_0 
al1owed_by^Ufi_9 
allowed_by_us_10 
allowed_by_UE_l1 
allowed by ns 12 
all 0 wed_by-.us_ 13 


- I 


= 1 


m - NEXT_H0VE(Bt. HOVE^IZECU)): 




I 

allowed_by_us [0l * allowed_by_us_0; 
allowed„by_us [11 ^ allowed by_ us _11 
allowed.by uaf2l =■ allowed3y_ug_2 : 
all Qwed_by_us [3] ■■ allowed_by_us_3 : 
al lo wed3y _us [ 41 = a 1 lowed3y _us_4: 
e l 1 owed_by_us [ 3 ] = all owe d3y _us _5; 
aiIowed3y3s[6] = ailowed_by^us3: 
aliowed_by_ust7] " allowed_by^us_7: 
allowed3y-US fSl " allowed by us 8: 
allowed by us [91 ^ allowed3y-Us_9; 
Bnowed_by_ust ID] ” allowed_by__us_10 

allowcd3y_U8f 11] = allowed_by_us_ll 
allowed_by_us[12 j = ailowed_by_us_l2 
alioved_by_iislUl = aiiowed3y_us_l3 


static void 

f 11 ter_for„leiigth_l5(piaceraent_t 'p♦ 
letter_[nask_l 'lelters_allowed» 
1e 1 1 er_mask_t * allowed_by_as) 

t 


movent * 111 , ‘last; 

const letter .mask. t global iiask 0 “ 
letters_allowedtp->where[0]]: 
letter_raask_t all owed_by_us_0 ” Q; 
conat letter_Qiaak_L global_mask_l 
letter3_allowed [p‘>vhere[ll ] t 
letter_!iiask_t allowed_by_us_l - 0: 
const ietter_tiiask_t giobal_naEk_2 “ 
lBtters_allowed fp->wheref?111 
letter .mask.t allowed by us 2 = 0; 
const 1 Btter_ifiaak_t gl obal_!nask_3 ** 
lettGrs_allowod[p >where [3]J: 
letter_aiask_t all owed_by_us_3 = 0: 
const ietter_iBask_t giobal_B!ask_4 “ 
letters_aiiowed[p*>where[4]l; 
letter mask t allowed by us .4 = 0; 
const letter mask t global mask 5 “ 
letters_allowed[p->where[5]]; 
lctter_i!iask_t allowed_by_us_5 0: 
const letter_mask„t giobal^mask^b “ 
letters_aliowedtp'^>where[6j J: 
ietter_inask_t ailowed3y_uB_6 - 0: 
const letter ..mask t global mask 7 - 
letters allowedfp->where [7] ]; 

1etter_mask_t al1owed_by_us„7 " 0; 
const leit.er_iaask^t global_mask_a - 
let ter shallowed [p ■ >where [8] J: 
Ietter_nLask_t aiiowed_by_us_8 « 0; 
const letter_mask^t global_mask_9 - 
letters allowedfp->wbere[9ll: 
letter tflask t sllowed_by_us_9 = 0: 
const letter_raa5k_t global_mask_l0 " 
lettBrs_allQwed[p->where[10]]; 
letter^mask^t allowed3y_us_l0 ^ 0: 
const letter_inask_t global_mask_ll ^ 
ietters_allDwed (p*>where[lll 1; 
letter maak_t allowed_by_wS-ll * 0: 
const letter_iiask_t g1obal_iiask_.! 2 “ 
lcitcrs_allowBd[p >where[lZl]: 
letter^mask^t allowed_by_us_l2 - 0; 
const letter_mask_t giobaljmask^lS • 
letters_allowed[p->vhere[13n ; 
letter mask t allowed.by_us_l3 = 0| 
const letter_mask_t global_mask_14 
lettcrs_allowed [p >whGce[l4]] : 
letterjnask^L allowed_by_usJ_14 = 0: 
last “ (move_t ‘) {{char pOrnove ^ 
(p->num_moves * 1) * M0VE_SIZE(15)); 
for {m “ p">i!iove: m->original word !“ NULL: ) 


If ( 


1(globai_mask_0 
I(global_mask_i 
I Cglobal_tBask_2 
ICglobal_mask^3 
1(giobal_mask_4 
((global mask 5 
I{global_mask_6 
I (global_mask_7 
I Cglobal_jnask_B 
I(global jaask„9 


& (1 « 01 >letter[03)) 
4 (1 « m >letter[ll)) 
& [1 << 11 >lettet[2])) 
& (1 « tii->ietter[3])) 
& (I « m*>l€tter UJ) 1 
& (1 « ni->Ietter [5] )} 
& (t ni-^letter [6])) 
& U « m >lettGr[7l3) 
b (1 « m >leLter[8])J 
b (i [ii->letter [9]) J 


!( globaljaasJelO b (1 « iii->Ietter[lOj )) 

!(global^mask.ll b (1 <( m->letterlll])) 

! CglQbal_mask_l2 b (1 <( n-Mettec [12])} 

! (global.mask^i3 b (1 « m >letter{nl)) 

! {global_mask_14 b (1 « m Hetter[14] 3)3 
‘copyO - ((void *')last)l0): 
void ‘copy! “ ((void **3last)[lj 
void *ccipy2 * ((void ’“)last)[2j 
void ‘copy3 “ ((void **)last)[3l 
void *copy4 = ((void •*)last)[4] 

((void '•}m)[0] * copyO: 

((void **)jn)U] * copyl; 

({void “)m) [2] “ copy?: 

((void “)iDji3] " copyi: 

((void **)m)[4| “ copy4: 
last-^original word - NOLL; 

-p'>num_moves; 

UsL NEXTJIOVEClast, M0VE_SIZE(15)) : 
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1 else { 

allowe d_b y_u e_0 
allowed^ by_us 1 
allowed,by_us_2 
aIlowed_by_us_3 
a 11 owe d_b y_tis_4 

allowed_by_^s_5 
all 0 wed_by_us_6 
allQved_by_ufi_? 
allowed_by_us_8 
all Q wed_by_ii s_ 9 
all ow e d_by _u s_l 0 
allQwed_by_ua_l1 
allowed_by_TJS_l 2 
allo¥ed_by_us_l3 
all 0 W6d_by_us _14 
in - NEXT_MOVE(m* 


- 1 « iii->letter [0]: 

= 1 « iii->letter [1]: 

=■ 1 « jii‘>lettai::[2]: 

" 1 « m->letter[3]i 

” 1 << m->letter[4]: 

“ 1 « ni->latter [5]; 

= 1 « in->letter[6j : 

“ I « m->letter[7] ; 

= i « ni->letter[31 : 

” 1 « m >lettar{^]: 

^ 3 << in->ietter [10]; 
^ 1 « m->lettei:tll] t 
= 1 « ra->letter[lZ]; 
= 1 « m->letter[133j 
“ 1 « m'>letter[l4j 1 
H0VE_SIZE(15)): 


1 

al 10wed_by10 ] ^ a 11 owed_b y_us_0; 
aliowed_by„us [1] = aLlowed„by_us_l 
allowed_by_u6[2] = allowed_by_’us_Z 
alioved_by_ua [3] = ailowed_by_^3_3 
aliowed_by_us [4] - allowed_by_us_4 
allowed_by_tig [5] “ allowed_by^u.s_5 
allowed_by_iis [6] = allowed_by_ufi_6 
allowed_by_iis [7l ^ allowed_by_us_7 
ailowed_by„us [8] = allowed_by_,u3_8 
a 11 0 we d_b y_u s [ 9) = a 11 owed_by_us _9 . 
all owed_b y_ufi [10] * *= al l owed_by_u s_l 0 
allo¥ed_by_iis [11] “ allowed_by_us_ll 
allowed3y_ua [12] " allowed_by^U-3_l2 
allowed_by_Ufl[13] = allowed_by_us_13 
allowed_by_us [14] « allovied_by_us_i4 


lypcdef filttr_func_t 

typedef void (*filter_ftiiic_t} (placement_t 
letter^Tiiask:_t letteir_inask_t *); 

static const fllter_func_t flltet_func[16] - | 0, 
f or_leiigth_l ^ 

filter_for_leTvgth_2, 
filter_for_length_3 ^ 
filter_foi:_lengtb_4 p 
filter_for_lsngth_5, 
filtei:_for_length_6 p 
fllte[:_for_leTigth_7 p 
filtej:_for_leiigth_e, 
filter_for_iength_9» 
filter_for_lengtb_10, 
filter_fcir_le]igth_ll, 
filter_for_lengt?i_I2. 
filter_for_length_13. 
filter_fot„iength_14, 
filter_for_leiigtb_15, 

1 ; 


/* Assorted constants, in m enum so debugger knows about them. 7 
enum I 

t Bit mask indicating all letters. V 
ALL.LETTERS = (1 « 26) ■ 1. 

r Bit mask Indicating "this square is not an intersectiim point 
' so ignore ifpV 

NOT_INTERpSKCTTQN_POTHT = OxyPFFFFFF. 

/* Empt>^ sKprarc in the puzzle. V 
EHPTY_SQUARE = 0 
I: 

static unsigned long current mark = 1: 

i^define set^placement^iiiarkfp) ((p) >Diatk “ curreiit_iiiark) 

Iklefine clear_place[iient_mark(p) {(p)->3iiark = current_Diark - 1) 
^define placement_ls_niarkedCp) ([p)->niark “ ciirrent_!iiark) 

^define clear_all_placeBient.marks 0 (t+current.mark) 


cotmi_nuni_placcments 

/* Retunis the total aumber of pbcctucnts in die puzzle. V 
atatic long, 

count„nuin_placeB5ents(Puzzle puzzle, long puzzle.size) 

t 

long X, y, niim.placeraenta 0; 


r HurizonUl placements. 7 
for (y ■ 0; y < puzzle_size; y++3 

for {x = 0; X < puzzle_size - 1; x++) 

If (puzzle[x][y] =“ EWPTY^SQUAKE 

puzzle[x + 1] ly] = IKmCSQUARB) 

[ 

++nui]i_placeiiients \ 

for (xt+: X < puzzl€_size && 

puzzle [x][yl “ EMPTY^SQUARE; x-hhJ 


r Vertical placements. 7 
for (x = 0: K < puzzle_size: x++) 

for Cy “ 0: y < puzzle_eiae - 1; y++) 
if (puzzle[x][y] == EMPTY^SQUARE && 

puzzlelxKy t i] — EHPTY_SQUARE) 

I 

++nuin_placemcritfi: 

for (y^? y K puzzle_size && 

puzzle[x][y] = EMPTY^SQUARE; y++) 


return nuffl_placeiiLents: 


idejotUyjJlacements 

static piaceiBent_t * 

ldentlfy_placetaents(Puzzle puzzle* long puzzle_size* 
long * niun.placeraents_pt c. 
placement_t 

*squgre_to_placement[kMaxSlze][kMaxSlze] [2] , 
char lnterestlng_length[kMaxSiza +1]) 

[ 

r Create an empty map from squares lo the pJaccmcnis that intcrsca, 7 
long X, y, iiuiD_placeiiients; 
placement,t *p* *place]nent: 

nura.placeaents = eount_nuiti_pl a cements (puzzle* puzzle_filze); 
p = placement = (placeiiient_t *) calloc {nu]ii_placemetits, 

sizeof p[0]); 

r Find all borizonUl placements. 7 
for (y = 0: y < puzzle_slzej y4+) 

for (x = 0: X < puzzle_slzG - 1; k++) 
if (puzzle[x] [y] = EMPTY.SQUARE U 

puzzle[x + l][y] = EMPTY^SQBARE) 

const long start.x = x; 
p->starT X = x: 
p->staTt_y = y; 
p->dx - 1; 
p >dy ^ 0; 

for (t X < pu 2 zle_size 

puzzlelxj[y] = EMPTY_SQUARE: x++) 
aquare_to_placei£ent [x] ly] [0] = p; 

■H-p: 

interesting length[x - atart.x] = 1: 


/* Find all vertical placements, 7 
for (x “ 0: X < puzzle_size; x++) 

for (y “ 0: y < puzzle_size ■ 1: y++) 

If (puzzlefx] fy] -- EMPTY SQUARE 

puzzlefxjly + 1] = EMPTY SQUARE) 

[ 

const long start_y ^ y; 
p->start_x = x: 
p->start_y - y: 

P‘>dx = 0; 
p->dy 1 : 

for (; y < puzzle,^s[ze && puzzlelx][y] = 
EMPTY_SQUARE: 

y-H-) 

square_to_placeinent [xj [yj [IJ = pr 

++p; 

interesting lengthly - start.y] = 1: 

] 

assertQj = &placement[numjilacemcnts]); V 

•num_placemeTit3_ptr ” num.placementsj 
return placement: 
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Cross-Platform C++ 

OOFILE and AppMaker keep your options open. 

http://www.highwayl .com,au/adsoftware/crossplatform-html 

Experienced cross-platfhrm developers have recommended for years the best way to get true native loak-and-feel is to factor 
out your application logic and develop interfaces separately on each platform. With the AppMaker Code Generator for 
Windows this common strategy is now automated. Generate PowerPlanf (or other) for your MaP interface and the 
industry-standard MFO"for Windowf. 

Even better, with our PowerPlant to MFC Portability Kit, includedfree with the generator, much of your existing 
PowerPlant code will compile directly under Windows. Remember, AppMaker can import screens from current source 
fight now to start generating a Windows version, no need to suffer through re-drawing each dialog 


Uiicrsccr4)laccmcnt_with_globaJ„ma5k 
r i'aktrs ihe Ibi of moves allowed by a placemeni and uses dial sei 
• to tiKhtcn what’s gbibally allowed for the squares it intcrseeb, 

•-Marks " any placements whose lists are changed as a result. 7 
static void 

intersecc_placement_witb_global_iitask(const placeiiient_t *p. 
letter_E[ask_t * globel_fliask) 

I 

const unsigned long iiiove_si 2 e =* p->jitove_size: 
int i: 

for (i - p->lGttorG_pGr_mDve - 1: J >- Ot i-) 

f 

ntove„t 

Ietter_ii]ask_t inesk = 0, g: 

r Figure out the union of all letters valid fi>r each square, 7 

for (tn " p->Tnove; n-)otlglnel_word i“ MILL; 
m - NEXT_MOVE(m* movo^slic}) 
tiiask 1= 1 f< m >lettGrIl3 E 

g = giobal_iaask[p’Hrhece[il J ; 
if ((g i mask) 1= g) 

I 

r Mark this neighbor as being in need of iirther refinement, 

* since we have just tlisallowed some of his moves. 7 

set_placei]ient_mark (p ^neighbor fij) ; 

/* Note die new, lighter resiriciion on this squaie */ 

global mask[p->whe£ofill = g & mask; 

] 

I 

) 

CTeale_ascii_ io_lcikT 

/* Creates an array mapping ^VSCII letter values lo numbers 0-25.7 
static void 

crfiate_ancll_to_1otter(unsigned char ascii_to_1etter) 

[ 

iiiC let: 

meinset [ascii^to^iettei: ^ 0, 23&I : 
for (let - 0: let <26: iet++) 
ascii_to_letter [ "a ■ + letl “ 

ascii to latter['A' \ let] = let; 

1 


pnniiion_words_by_leiigih 

static void 

partition_words_by_iength(char *dictionary[], long dict_size» 
const char interesting_lengthIkMaxSize -f 1] , 
const char ••vords of length[kMaxSize f 1]^ 
long nurTi_words_or_lGngth [kHaxSize f 1], 
void • * taeia_to_Iree_oii_c 1 eanup) 

( 


long Tium^,word3_left [kMaxSize + 1], num_useful_words* 
i. j. w, k: 
const char **r: 
void * raw_wordE_mejL: 

/• iigure oui how many words there are of each kngih 7 
for (i 0: 1 <“ kKaxSite; i++) 
num.. VO r d s_ D fleng th [ i] = 0; 
nura_useful_words = 0: 
for (w = 0; w < cEict_slze: w-M-} 

( 

slze_t len = sttlentdlctionary[vj)s 

if (len kMaxSize d;6! interesting_leTigth [len]) 

++num words of lengtbflenl ; 

-»4num_usefiji_words; 

] 

] 

/•Allocate room for a pointer vector for each word length. 

•Well just put all of the pointer vectors together into 

* one big block of memory, separated by a NULL pointer V 
raw_words_incin “ 

malloc [ (imnuuseEul^vords + kMaxSizc + 1) * sizeof rIO]); 
r = (const char ''*) rawjwQrds_iiieiii: 
for (k = 0: k <= kFlaxSxae: k++) 

{ 

const long TniiD_words_Qf_this_length “ 
num_wordEi_.of .length fk] ; 
wcirds_or_lcngth [k] = r: 
rItium_wurdG_of_thiG_lengtb] - NULL; 
r f=^ nuni_vords_o£_this_length + 1; 

/* leave room for lenninaiing NULL 7 

] 

/* Note the words of each length. 7 
memc py {n um_w o r d s_l eft* nu m_wo rd s_o F_l e n gt b. 

sized £ nuti3^wurds_l eft); 
for tj - 0: j < dict_size: j++) 

( 

size t Len = strLonfdictionary[j 1); 
if (Ten <= kMaxSize intaresting_lengthflenl) 
wordG_of„length [len] [—mJiii_vords_ left [len] ] “ 


r Report the block of mcmcjry to free when done. 7 
‘mem to free on cleanup = taw words mem; 
i 


tighten_constniints 

static int 

tlghten_constraint s(placement_t * placement * long 
nuTn_placements* 
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f 


l<jtter_mask_t *letter5_allpwed, int (io_acycllc) 


placemeut_t **ccig_stack* **stack, *p; 
long n: 

stack “ orig_stack ^ mallocC (n\m_placenients + 1) * 
slaeof orlg stack(01); 

*stack++ = NULL; 

t On entry, wc'w marked every placement that needs to be explored 
* further, so push those on the stack. 7 
for Cn “ num^piacementa - 1; n >= 0: n—) 

placemfint.t *t - lacement[n]: 

if (placement^is^inarkedCt)) 

‘siockd^^ “ t; 

] 


while C(p “ ‘“Stack) t- NULL) 

I 

letter cuask^t allowed_by_us [kMaxSize] j 
long I; 

if (p >dane [| 

C!do_acycllc p->ia_cycle = NOT^N^CmE)) 
continue; 

if (p'>lettetfi per.move C 

si^eof filter_func / sizeof fllter_£unc[0l} 
t*flltcr_func[p >lQtfcers_por_iaovel) (p, 

1 e L t e rs_a 11 owed » all owe<l„by_u s); 

else 


letter mask.t global„maEk(kMaxSize]; 
long I, moversize; 
move_t ‘Ml Mast: 

move_size = p >iDove_size; 

mem6et{allowed_by_us, 0* sizeof allovfe<l_by_us); 

/* For speedy stash fd^bally allowed letters in linear array 7 

for (i " 0: i < p-klotters^per^move; 1++) 

global_mask[i] = lettcrs_3ilowedIp >whcre [11]: 

f* Loop throng]] aJl words here, discarding iJkgai words and 
' acentmg a new union mask. 7 

last - (move t *) {(char M p->iBove + 

(p>nutQ_tnoves ^ IJ * p’>inove_slze); 
for (m * p ^move; m >ai:iginaI_word !•' NULL: ) 

long j; 

r Sec if word is legal. 7 

for ij ” p->letters, per move ’ 1; j 0; j-) 
if CI (global_maskIj] A (1 « [ji->letter[jl))) 
break; 

if £J < 0) 

I 

/* Ifs legal. Note the possible letters and move on. V 
long k: 

[or (k p >letter3_per_mcive J; k >- 0: k-) 
all{jwe{l_by_ns[k] |“ 1 <C ra ^IctLerlk); 
m ^ NEXT_H0VE(iti. move_ai2a} ; 
i 

else 

t 

/* ]ts illegal. Delete this move by replacing it with 

* the last move in the list. FrofUing shows this is 

* a hotspot, so inline a mcmepy using our knowledge 

* about what moves look like. 7 

char 'from, ‘to; 
long ctr; 

from ^ (char *) last; 
to * (char *j m; 
for (ctr = iDove_size; 

(ctr -= sizeof(void ‘IJ >" 0; ) 
‘(void “){to t etr) ^ 

‘(void “Kfrom t Ctrl; 

1ast->orlgin3l_worti NTn,L; 

-p >niiJii_iiioves; 

last = HHXT^MOVEdast. -move^size): 

I 

1 


} 

if (p->num_movefi — 0) 

I 

r No moves —> no sotiition. Quit now! 7 
freetorig^stack); 
return 0; 

1 

r Propagate our constraints to the gUdxil grid. If we actually 
‘ dunge anything, note that we ne^ to rccompute the valid 
* words list ftw whomever interseets the newly tightened square. 7 
for (i ” p->letters_per_move 1; i >= 0; i-J 
t 

letter_maak_t g ^ letters_aliowed |.p->where[ij J ; 
if (£g & nlloved_by_us [il) I-- g) 

( 

placeiBsnt. t *nbr; 
letiers_allowed [p >where[!]] " 
g 5i allowed^by_us[i]; 
nbr = p->neighbor[lJ : 
if (!placem€nt_is_inarked{nbi:)) 

I 

*stack++ = nbr; 
n€t_placement mark(nbr): 

1 

1 

1 

clear placement^mark(p); 

} 

free£orig„stack); 
return 1; 


static void 

place_word(Puzzle puzzle, int 
const char *word) 


place_wcjrd 


X, Int y, Int dx* Int dy, 


for (: ‘word; vord-Hr) 

I 

pnzzlnlxi[y] “ ‘word: 
X += dx: 
y += dy; 


1 


static void 

place_move(Puzzle puzzle, placeiiient_t *p, move_t 
t 


place., word (puzzle, p'>stan:_x. p->start_y. 

p->dx, p*>dy* ii->original_word): 


•m) 


place.move 


solve_triviai_placenients 

r Go ahead and fill in every placement where there's only one choice, ‘/ 
static void 

solve trivial_placeinente(Puzzle puzzle, piaceiiient_t 
‘placement, 

long num_placements) 

I 

long i; 

f Go ahead and make any move wlicic there s only one choice. 
for (i ” 0; i < iiuni_placemants; 1++) 

I 

placement_t ‘p ^placement [i]; 
if (p->nura_raoves == 1) 

I 

place_iiiove (puzzle, p, &p' >move [0]); 
freeCplacementlil.move); 
placement[11,move “ NULL; 
p->num_inoven “ 0; 
p >done ^ 1; 

1 

I 

f 


cieate. placements 

static placemeni_L ‘ 

create_placeiEeiLts(Fuzzle puzzle, long puzzle_slze, 
char ‘dictionary[1, long dict_size, 
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letter_ntask_t letters_anowe(i [kKaxSlze * kMaxSizeK 
long *iettecs_a 11 owed„s 1 ze_ptr» 
long ' nuaj_p 1 aceine n ts_ptr) 


I 

/• [>o wr ate about wotds of kngih n? 7 
char Interestlng^longtbfkWsxSize + 1]: 
long n* nuauplaceiienis: 
piac€niant_t * placement: 

const char •*words_of_lengtb[kMnxStKc + ll: 
long num_vords_of_lengthlkHaxSlze + !li 
move t *’hash table - NUU.: 
unGigned long max hafih_table_size = 0; 
void 'meai_to_froe: 

r Maps [AZa 2| to the mimbers I 26, ft if all others// 

unsigned char aGcil_to_lettec[?S6] : 

/ Maps intcrNcction squares to utiiqiic eoniigumis nnmbcfs. 

* tfodofined gart^age lor non-interscaion squares// 

unsigned long 0 quaro_to paeked_linear[kMaxSizeJ [kKaxStze]s 
unsigned long num_packed_lInears = 0: 

/• Gives us the up to two plactwnis that intersect the given square// 
placeiiient_t •square_to_plnceiiienL [kttaxSfzel [kM;ixSizel [2]: 

r Initialto assorted arrays. 7 

inemsct(square_to_plscem€nt. 0. siaeof square_to_placeii(enO: 
raemset(intoresLlng^length. 0, slaeof intereEting_length): 

treate_aGcil_to_letter(sscll_E o_lot^er); 

/* Creaic aJl of the placement strucis. etc, V 
placement " identify, placements {puzzle. puzzle_slzc, 

4fnuiii_pl aceiaents. Rqiiare_to_p la cement * 
interestlng_leiiglb): 

/ Figure out all of the words of tltc various lengths we want. 7 
partition_worde_by_lengtb{dietiouary. dict_sIze. 
i nter estitig._length. vo rda_of_1 ength, 
nuii^WG rde, of _1 ength, 

&inem_to_free): 

f* Loop ilirougli each partition and set up its neighbors and mcjve M, 

* and rcfket our move list <jn ihe global stare. V 
foe (n 0^ fl < num.piacementa; n++) 

I 

plnccraent,t *t - ^placement{nj; 
long nuiiL.lniersect_Rqu3res “ 0 ; 
long X. y. dx, dy, length; 
letter_mask_t mask[kMaxSiae]: 

/ If anyone tttarked us as needing fintbcr icfincmcnt, clear it 
• since we re going lij do lhai itfincnieni now. 7 
clear_placement markCt): 

dx “ t->dx; 
dy “ t->dy: 

for (x - t'>start_x. y ~ t‘>start_y. length - 0; 

X < puzzle size && y < puz 2 le_sixe U 

puzzlefxlfyl — EMFTY_SQUAKE: 

K += dxi y +” dy, lengtb+t) 

I 

placement.t ‘pO - square_Lo_placement [x] [yUOl; 
placement_t ^nbri 

r default to all letters being allowed for lliis square. 7 

mask [length] - NOT INTERSECTI0N_P0INT: 




m 


QflOWbound soflt^ 

^ HIGH PERFORMANCE 

Imaging, Annotation & Plug-in 
Development Tools 

KasterMaster 7*0 Powerful, mulU-platform raster 
imaging support for 60+ Raster Formats. Familiar API and 
well-proven technology in use worldwide by companies 
such as BP. Chase Manhattan, Ford, Gannett, HR IMSL Kodak, 
LEXIS-NEXIS, Polaroid, Toyo, Unisys, Xerox and more. 
Formats: TIF, JPEG, MO:DCA, CALS, PNG, DICOM, Rashpix. - 
BMR BRK, G3, G4, GIF, JED. KFX, MAC, tOCA. PCX, TGA, 
WFX and more. Features include: (* New for Version 7) 

* Compresston t - CMYK 4 Plane Support * 

- Image Processing * 10-16 bit Gray Scale '* 

’ Despeckle & Deskew * Ar^ll-Atiasing in Sliver * . 

* Multipage TWAIN Scanning - Fit to Wdth & Height * ' ^ 

* Pan, Zoom, Scroll 
// • Irnage Editing 

. - Auto Aspect Ratio 

* Alpha Chanel Support * 


* Tiled Image Support * 

• MedicaMmaging 

* Animated GIF * 

• Image Encryption ‘ & mom 




RasterNdte 2,(l Annotalion/Redlining toolkit. Features 
indude: Sticky Notes. Lines, Ellipses, Freehand Drawing, 
Polygons, Highlighting, Redaction, Multiple Annotation layers. 

RasterNet 2M Plugjn for Netscape and Internet Explorer j 
Read 60+ Raster Formats! Simple drop In library makes it easy 
er^bie standard browsers to read your Ifitemet/lntranet pages 

Platforms lridude:VVinWNttVii»L^^. Mac $eK^ ' 

"■'i Visit . 



“ sluarcs, 7 

if (iibr’>letters_pet_move 0) 
mask[length] “ 
lcLterg_allf)we(l 

[square_to_packRd_linear fx![yll: 

else 

I 


1 


raaskllengthl ^ ALL.LEri'EKS; 
letters allowed inui!i_packed_liriearsl = 
ALL.LETTERS; 

ijquBre_to_p3nked linear[x][y] “ 
nuni^acked linears++: 


/* Wc inrersetted wrnic other pUcemcm here, llijs mcaas wc 
' care about this square// 

t >nelghbor[mim intersect^squaresj “ nbr; 
t->where[nujn_lnternec.t squares] = 

square_Lo_pflcked_l Ineac [x] [y] ; 
nuia_interaect_squurcs++; 

I 

1 


if (pO 1= NULL ii£t pO 1- t) 
nbr -■ pO : 
else 
t 

placement t *pl - square_to_piacement[xj[y] [U: 
if (pi I- NlfLL &A pi !- t) 
nbr pi; 
else 

abr • NULL; 

I 

if {nbr !« NULL) 

I 

/* If wc are the first partitiim tii visit this intersect 

* point {i.c, this oci^bof hasn't heen pnoecsscit) then 

• add tills square to the global list of interesting 


t->letters_pe]:_inovc ^ mi in intersect squares; 
t->move_size ^ MOVE_SIZE(riiifli^lntersect squares): 

if {t->letters_per_iiove ^ 0) 

t 

t Plug in anything that fits// 

if Cuum_words_nf length!length] “ 0) 

I 

f* No solution! 7 

goto done: 

1 

place word(puzzle, t->Statt_X* t>startly. 

t->dx, t'>dy* vords_ot_length[length][0]): 
t >donc ^ 1: 
t->nuiQ_BiuvGs - 0; 
t->inave = NULL; 
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eontinuft; 

1 

r Create alJ the moves for this placement. 7 
t->niove - (igve_t *) malloc (tmim_words of letigthfTengthJ+l) 

* MOVKjTZEClengLh]); 

t 

const char **«; 

move_t *m * t >nove; 

unsigned long hash_rabXe_sise: 

hB8h_tabie_aize - imm_vords. of length[length] “ 1+16; 
If {ba 8 h_table_sl 2 € > niax_hash_table_sizel 
( 

free(haflh_ta'blej: 

max_haBh_tablG_aize “ liash_tabie_size; 
hash^table = calloc(iiiax 3 ash_table_sl 2 e* 
slzeof hash_table[0]) ; 

1 

else 

menset(haflb„table, {)* hash_table_alze * 
slzBof hash_table[0]3: 

for (w - words_of_length [length] ; 'w; w++3 

const char ’s * *w; 
unsigned long hash: 
long ix, out: 

hash “ 1; 

for (ix “ out = 0: stix] 1= "\0‘; ix++) 
if (masklix] !- NOT^INTERSECTIOK_POIKT) 

( 

int letter = 

aselI_to_letterHiinsigned char) s[lxJJ: 
if ((iiask[ixl 6 (1 « letter)) “ 0) 
break; 

hash = (hash ‘ 26) + letter; 
ni->letter [out++l ^ letter; 

1 

/* If wc made it all rhe way lo the end witliout faUiitg, 

* then arid this wtxtl to the list, 7 
if (slixj - '\0‘) 

( 

const move t 'test_3iiove; 
long j; 

hash %* hash_table_size: 

while C(test^jnovs = hash tablefhasbl) !“ NlftJ.) 
t 

for (J ^ t->letters_per_rot>VG 1; j-) 

if Etest_niovo >letter[j] 1= i»->ietter[jj) 
break; 
if Cj < 03 
break; 

if (++hash >= hash table size) 
hash hash tahlo_atze; 

I 

if (tPET^novo NULL) 

I 

hash^tabie [hash] m; 
m->originai_word ^ *w; 

++t‘>nuni_i!ioveE: 

m “ tiEXT MOVE (in K t ->movo_sizo3; 
f 
I 

* 

/‘Tetminau- tjur list with a NULL poimer.V 
m->original_word - NULL; 

I 

r 0>nipute global imphratiems of the legal wonb here. V 

in!:erscci4>lacciient„with_global_aa&k(t, letters .allowed); 


8olve_tflvial_placementB(puzzle, placenent, nuii)_placeMents); 
done: 

/* We don’t need thiji memory^ any more, so free ii. 7 
freG(hash_tablo); 


free (Tnem_to_froe); 

r Recursivet)' propaptc aimind coDsiraints. 7 
1 1 ght en_coiis t raint s (p 1 ac ene nt. nun, p lac eiaen ts, 
letters^allowed. 1); 

* lettera_allowed size ptr * num_packed_linears: 
'nutn piacfitnfints_ptr “ nutn_placamenta; 
return plscemeni: 

1 


partition_aux 

r Recursive helper funoiun for ^partitkm_aiid_nujicjcycles'^7 
static long 

partitlon_aux{placement_t placeaent_t “'partition, 

^ placeMent_t *parerit, long depth) 

p1aceraent_t * * nbr a , 'nbr ; 
long retvai = depth: 

/* Add this pLacemem to our partitkm.*/ 
set_placement inark(p): 
p->deptli ” depth: 
p->in_cycle = NOT.HJ.CYCLE; 
if (Ip >done) 

I 

*'partition = p: 

++*partition; 

for (nbrs = p >nclghbot; (nbr = *nbra) 1“ NULL: nbts++) 
long x; 

if (nbr “ parent) 
continue; 

if (plaeGmeiit_is_iaarked(nbr)) 

X = nbr >depth; 
else 

X - partitlon_auK£nbr* partition^ p. depth + 13; 
if (x retvai) 

( 

p->in_cycle = lN_aaE; 
retvai = x; 

3 

1 

1 

return (p >in_cycle IN_C5fGLi£) 1 retvai ; 10000000: 


pariiitt)n_and_maric_qTl£^ 

f Store all mjn-sojvcd platcmcnu. reachable frtjm rtiot that are pan of 
• stune cydt into partiiion. 7 
static long 

partition_and_mark_cycles{placeiiienx_t 'root* 
plac ement^t '* partition) 

I 

pl3ceinent_t “end_partitioii, **in. “out. ’p: 

r IhJi everytJiiog in die partition into the array, and mark each 
' thafis part of a cycle, 7 
end„partltIon “ poctlLion: 
clDar_all_plucuraent_raarks(3; 
partitioD_aux(raot* £rend_partitlon* NULL. 1): 

*ond„partiticin ^ NULL: 

r Remove everything thats not part of a cycle. 7 
for (in = ont = partition; {p “ ‘in) 1“ 0: in++) 
if (p >in_cyclG 1N_CYCLE) 

'out++ ^ p: 

'out - NULL; 

return out * partition; 

f 


jailve partition 

r Tries to solve a partition. Returns true m success. 7 
static int 

soive_partition{Puzzle puzzle* placeatent_t ‘^partition. 

long partition size. letter„iBask_L 'letters^alloved* 
long letters_allowod_size, plucement_t *ali_placemente, 
long all_placements_size. placeaent^t 'start) 

placement_t *p* ‘most^popular; 
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moV e_t ‘ t>a ekup_inove < * m; 

long *backup_num_niove5. 1: 

letter mssk.t *backup_ietters_alloweds 

placement^t '^new partition: 

int success “ D: 

long bla_si 2 e: 

long Diove^size: 

/* Make a backup copy of t)ur lcttcrs_alJowcd array. 7 
bla_sl7.e ^ letters_aUoved_si2:e * 

Kizeof backup_letters_ailovod[0]; 
backup^loi torsos Hawed ^ jiialloc{bla_si7:e); 
menicpytbackup_lctte.rs_allowed. lsttars_alio¥ed, bla_Sizo) ; 

r Make backup copies of our nio^T iists. V 
backup _move maliocCpartitiorusi^o * slzeof backup_Eiiove LOj): 
backup num_moves = 

malIac(partition„sise ’ sizeof backup_nuiiL_inoves[0]}: 

/•Allocate room to hold tbliv. V 
iiew_partititjn = 

tnalloc( (all_placefflenta„siae 1) * slzeof new„partition [0]): 

p ^ most_popular = MLL: 

for (1 “ Oj i < partition_size: i++) 

[ 

piacement_t *q " partitlonli]; 
long size: 

bflckup_nuii3_iiioveE [ij = q->nuin_nQves: 
size = (q’>nuni_moves + IJ * q->inQye_slze: 
backup_Ttiovfi [i 1 = ma 1 loc(size): 
meincpy (backup^ciove [i1 , q' >iaove. size): 

if £q ^ start) 

P q: 

else if (Tiiost_popular = MULL 

I I q'>letters_per_iDove > 

mo st_p op ular-) letter s_pe r_nio ve) 

iEiosl_popular “ q: 

I 

if (p = NULL) 
p = most .popular: 

/* Hypothetically lay down this mtivc, 7 
movers ize “ p >move_size; 
for {m “ p->iBove; m >criglnal .word; 

ffl ^ NKXT_M0VECm. move.alze)) 

( 

Tong r; 

/•Actually lay this move tlown cm the board. •/ 
piace_iEove(puzzle» p, in): 

r Rcmanbcr that Uiis placctucnt is "done”. V 
p->done = 1: 

r lighTen grid and update all neighbors who may ore, 7 
clear.all_plnccmeTit,.raerksC) : 

for it ^ p >letIers.peremove - 1; r >*= 0: r-) 

f 

ietter.mask.t g - letters_allowed IpOwherelr] 1; 
letter_mask_t mask = I << oi >lottor[r] : 
if (g != mask) 

I 

le tterfl.al lowed [p->wherelrj ] ' mask; 
Bet_piaccment_mark(p'>neighbor [r j); 

1 

I 

/’ Propagate cemstrainte and check for coninadiction, 7 

if CItighten, constraints[all_placemenxs, 

uli_placGinentfl_sl 2 e. letters_allowed. U)) 
goto failed: 


I 

placement^t ‘•nbrs. *nbr: 

/• No contradictiem yet, so try our children, 7 

for (nbrs " p->nelghbor: (nbr = •nbrs) 1= 0: nbra+f) 

I 



Speed is essential in all database projects, but not at the expanse of stability. You 
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workstations, c-tree Plus's snrfall footprint end excepbenal performince has also 
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Mac, Check out www.faprcom.coTn for detailed infarmadon. Youll be glad you did. 
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□ato History 
File Mirroring 
Rollback-Forward 
And Deadlock ResdulJnn 
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letters_allowed); 


long new_partltion_si 2 e: 
now_partiLion_sizG " 

partition_and_mark_cycle6(nbr» nev partition): 
if {□ev_4jarcition„size > 0 && 

t aolva_partltion(puzzle * new_partltlon, 

new pa rtitlDn_a t z e, letter 3_aiiowed, 
letters_allowed_sizG, ull_placeiientfi * 
a H_placemGrits_size, nb t)) 
goto failed; 

1 

I 

r Woohoo! Wc did it! V 
success 1: 
break; 

/*This didn't worki so restore state. 7 
failed; 

p >done ” 0: 

for (r = 0: r < partition size; t++) 

I 

piicement_t *q part ition [r]; 
q*>num_aoves “ backiip_iiuii3_iflDves (rj: 

/* f13CME* don’t acliylly need to copy on the Last pass.. 

* just assign fkiintcr to backup nicttiory ami free the bad copy. 7 
raeac py (q * >ino ve, ha ckup_Hiove 1 r K 

(q-^niiBi_moves + 1) * q-)^Biove size); 

) 

oientcpy{latters_a1 lowed, backup_lettei:s_ailowed» 

lGtters_allowed„aize * sizeof iettars^allowEd[0]); 


r Houscclcaning. 7 
free(new_partitlon): 
free(backup, letters all owed); 
for (i " 0: 1 < pariition_3lze; i++) 
free£backiip_reovc [i]): 
free{backup_nujii_Bioves}; 
f ree£backup_iiipve); 

return success; 

) 


solvc_at7cJic_aux 

staiic void 

solve_acyclic_aux(puzzle puzzle, placctnent^t *p* 

letter_jjiask_t •letters_allowed) 

I 

f Find any kjjal mow and make it, 7 
iiiove_t *nj; 

long move^size, loop_start; 


r Stop looking lor a word. 7 
break; 

] 

J 

) 


sotve_acycIic_stragglei*s 

/*Thc main algoriUjui guarantees we si>lvc things that arc ptart of 
* cycles but not those things which are not pan of qrdcs, bcxaitsc 
' they arc uttcriy trivial given the information we ve computed. 

■ This solves thcise last acyclic pieces. V 
static void 

Bolve_acyelic_stragglers(Puzzle puzzle, 

placeiiient_t 'placement, long nuifl_placenientf5, 
lettGr:_jEaak_t: •iettere_allowed) 

I 

long i: 

for (1 " 0; i < num_placeiiients; i-H-) 

placemeiit_t 'p = ^placement lij : 
if (!p->done && p->nu«_njoves > OJ 

solve_acyciic_aux(puzzle, p, letterB_allowed); 


Crnssswofid 

void CrosswordC 

Puzzle tbePuzzle, r return solved puzzle here 7 
char * dictionary fl. t array of wtirds to choose fjiam 7 
long puzzlesIze * /* mimhcf of it}ws/cols in puzzle 7 

1 0 n g d 1 ct S J ze r number of wuids in dicilonary 7 

f 

lotter_niask_t letter s_allowed[kHaxSize ' kMaxSizc] ; 
long nura_placenients* i* 1 etters^al lowcd_size: 
placement t *placemenT, ^'parLition; 
int sticceas = 1: 

/* Create our placement siruciures. 7 
placement = create_placeTnentfl£thePuzzle, puzzleSlze, 
dictionary, dictSize, letters_a1 lowed, 

^letters allowGd_Bizo. ^num^placements); 

r Find disjoint portions of the gjaph and solve tltem. 7 

partitloD = ]iialloc({mun_placeBientB + 1) * filzeof partltfontO]); 
for (i = 0; i < num.placementi!; lt+) 

placement t “p “ ^placeneni[i]: 

if {p->mm_ittOves > 0 iSr p >in_t7cU = CYCLENESS^UMNOWH) 


if (p->done) 
return; 


move_sizc “ p >«ove_size; 
loop_start = p >letters_per_inove * 1; 


for (m 
i 


p->move; m‘>orlglnal_worfi; 

in “ NKXT_M0VE (ki , inoye_size)) 


long k; 

for (k “ loop_start: k >“ 0; k-) 

if (E (lettets_allowed Ip->wherefkll & 

(I « in->letterrkl))) 

break: 

if (k < 0) 


I 


long j: 


long partition_size = 

partition, and mark cycles(p. partftion): 
if (partition, size > (3) 

success L=^ nolve_part il ton(thePuzzle, partition, 
part 1Tion^sIzo■ lettershallowed, 
letters_allowed_filze, placement, 
uam^placements. NULL]; 


if (success) 

I 

r Kccompine all constraints for rvtfyonc not yci solved V 
for (1 ^ 0; i < BumDlaceiHents: i++) 
set_placement_mark(&placetitent Fi]); 
tigliten_conetraints(plaGeaient, nuai^placetaonis, 
letters allowed* I); 


/* Make the move. 7 

piace_move(puzzle* p, m); 

/"Tighten up the board for everyone else.7 

for (J loop_Htart; j 0: j-) 

lettern_allowed[p->¥here[jll = I « ni >lettqt [J]; 

P'>done - 1: 

/* Flood out to our neighbors and do them too, 7 

for (j * loop_start: J >” 0; j*) 

solve_acyclic_aux(puzzle, p->neighborfjj, 


r tio thitJi^h and solve them. 7 

sol ve_a eye 1 ic_s t ra ggl e rs (t hePuz z 1 e, p la c ena nt. 

num_ 4 ilacem€nts* letters allowed): 

/* House elraning. 7 
fraa{partition); 

for (i “ 0; i < num^placeinents; i++J 
free(placement[i],moveJ; 
free(placement); 
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by Nicholas C ''nick.c'' DeMello <online®niactecb.com> 


With the (X)fning of Itliiipsocly, Macintosh platform developers 
are going to have a wealth fjf powerful new tools at our disposal, 
including tools that will allow us to dLsfday spectacular and 
interactive 30 grapliics. Two 30 grapliics technologies vying for 
die center stage in Rhapstxly are OpenGL and Quit:kDraw 3D. 

OpfnGL 

Although Apple hasn’t announced a decision at the Litne this 
column went to press, RhapscKly will likely suppcirt OpenGL. 
Originally developed as tlie grapliics library for Silicon Graphics Iris 
systems in 1992, OpenGL luis since evolved into the most widely 
accepted ctoss platfomi graphics Aid. It offers low level mutines for 
defining, manipulating, and rendering 2D and 3D objects 
inde|x?ndent of the user interface, Rspedally popular with CAD 
programmetN and the de facto standard for st'ienUlV and 
engineering applications, OpenGL has nemarkabiy fast drawing 
routines (largely bec:aLLS 0 most implementations of OpenGL 
interface direttly widi liaatware). The API includes functions for 
easily scaling, traaslating, and notating 3D objects, while offering 
control of polygon shading, dearth cueing, and atmcxspheric effects 
in die rendering of those objects to a 2D rcjiresentation. To learn 
more abtiut OfsenGL, visit the OpttiGL information center. The 
information center leports the latest OpenGL news and hosts a 
collection of resources (including one page with links to over 
dozen LAQ's on various as]:)ects of OpenGL programming), 

1lie first Mac OS implementatioti of OpenGL was developed by 
0)nix Graphics, and their web site displays a ludf dozen impressive 
demonstration models. Conix OpenGL offers royalty free distribution 
with yotrr pnxluct and will run under Mac 0$ 7 — whic!h means you 
can start developing and disiril^uiing OpenGL products immediately. 
Folks looking into Java should also check out Magicum (an OpenGL 
implementation for Java) by Amane Tedinologies. 

Willi lialf a decade of development, OpenGL itpresents a 
maiune API that is well SLip|x)rted by a w^eiiltli of example code, a 
large Irase of developers (so many, they started tlieir own new^sgroup 
and exteasive docimientaiion (including an online reference at 
HP's welwite). ff your application requires fast drawing or 3D 
representiition, you should take a daser !f.M>k at what OpenGL offers. 

OpenGL Infonnatien Center, Hosting the OpenGL FAQ Index 
<http ://www.openg I. or q/> 

<http ://wvvw.openg I .Of g/Oevelope rs^Docurn eri Id 1 i Q n/d e vf 3 q I i St .ti im I ■> 

OpenGL for the Macintosh, by Conix Graphics 
<http://vwiw,ct)nix3d,c£>mfe- 
Magician: OpenGL for Java 
< htt p ://wwiA'. arcana. co. uk/p rod u cts/m agj cia n/> 

Some Example Code for OpenGL 
<http 7 /trant,sgi .c (HTi/openql/ex 3 Tnp 1 es/e 3 <anif)lHS.html> 


The OpenGL Newsgroup 

< news:carTip.gra ph res. api. open G L> 

OpenGL 1.1 Reference Online 

< http;//www, hp. CO m/wsg/products/g rfx/OpenG 1 Meb {Retcren ce. h tm I > 

QitickDraw 5D 

[n the Summer of 1995, Apple introduced it’s own cioss- 
platfonn gniphics Aid — QuickDraw 3D. 'Lhe strengths of 
QuickDraw 30 are common Apple themes — it’s easy to use, tlie 
graphics are Sfx:ctacular, and the icclmology is plug & [>lay. While 
Iffiapsody is likely to siippon 0]X3nGL, QuickDraw 3D will certainly 
Ixf diene as well, Apple is not likely to abandon either this promising 
technology or die developers who liave invested in it. 

QuickDraw 3D may be less a competitor to OpenGL than a 
complement to it, A higher level API tlian OpenGL, QuickDraw 3D 
is fully objea oriented and supports eomplex geometries like non- 
uiiifbrm rational IKspUne (NUTtB) curves. Other high level features 
of the QD3D layer, include a portable data fonnat (the 3D 
metafile), and an interactive irnderer make it easier to work widi 
than OpenGL. To get started with QuickDraw 3D you’ll want to 
download the SDK from Apple’s QuickDraw 3D site. While 
example QD3D code can l)e hard to coitx: by, Brian Greenstone 
of Pangea Software has made die source code for his 
OneoAnimaUn available — make sure to downJoad a copy. Also, 
consider joining the QuickDraw 3D mailing lisL 

QuickDra w 3D msides on a hardw^are al)straaion layer called die 
QuickDraw 3D AcTcleration Layer. Tfie interface to thus layer is called 
ItAVE (Render Act'eleraiion Viriuid Engine) and can 1x3 aa^ml either 
diiecdy fmm your appliaition or by QuickDiaw 3D. Hardware 
acceleration or .software enfrmcemenLs can be added to QuickDraw 
3D by regisicTing either with RAVE, For example, UghtWork Design 
has develo|X3d five plug-ins ftjr QuickDraw 30 tliat offer advanced 
ray tracing feanites including ray cast shadows, radiosity, glass like 
reffeetance, transparency, and aml>ient lighting. With die lightWork 
plug-ins your QuickDraw 3D applications can generate spectaaikr 
plKXo-realistic images. To find out more alxjut the QuickDraw 3D 
Acceleration layer see Apple's QuickDraw^ 3D RAVE pages. 

Apple'^ QuickDraw TD Site (including the SDK) 

< http://qu icJ(draw3d,apple,com/> 

Oreo Animator Source Code* Provided by Pangea Software 

< htt p:/ /WWW. Tea 11 i m p. net/- pa agea/> 

To Sign Up for the QD3D Mailing List 

<quickd f aw- 3d ■ r eq u te de V too I s. d pple. tom ;> 

LightWork Plugins, Enhanced Rendering for QD3D 

< h rtp ://www J ightwork.com/qd3d/> 

QuickDraw 3D Rave and the QuickDraw 3D Acceleration Layer 

< http ://de vwor Id .a ppl exom/de v/iech suppori/i ns j demac/ 
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TIPS & 
TIDBITS 


by Steve Sisak 



Rltimning tcp/ip Appucvm)NS Witholtt 

A Nf™ork 

]n order to run TCP/IP applications 
(cliunLs and servers) without being 
connected to a netw-ork, a Mac still needs to 
setup as if it were on a network. There 
are some special requia-ments in doing diis 
for an unnetworked niadiinc, 

Hthernet cannot be used unless you 
are connected to a liub or another Ethernet device (if you are, 
you don't need the following method). So, you will instead 
have to use AppleTalk over lociilTalk (whethcT t>r not youTe 
actually connected to a LocalTalk network). This niclhod uses 
MaetP which is a way t>f tising TCP/IP within AppleTalk. 

• AppleTalk must be on. You will want it to be using LocalTalk 
(use the AppleTalk control panel in Open Iransjx>n, or the 
old Neuvork cuniroi panel in other systetiis). 

• Depending on which you’re using, the MacTCP or 
OpenTniasport TCP/IP contrt)! panel has to I'je configured to 
connect using AppleTalk/MaclP. 

• Set your TCP connection to AppleTalk (MaclP) or UH:alTalk, 

• Configure your local address to Ix^ obtained manually* 

• Set your IP Address to 192.0.1.2 (cla.ss Cl 

• Leave the Domain Name Server fielcLs blank (unless you are 
nmning a Domain Name Server on your mac, in which ca.se 
set the fields to ptnnt to your local machine). 


• Any Routing/Gateway fields should Lxr left blank (or set to 
0.n,0.0 if they must lie filled in)* 

• In t^penTransjKm, click the ‘‘Select Zone**/ button in the 
“TCP/IP” control panel and set it to “Cunent Ai)pleTalk zone”. 

• Subnet tnask and any other fields are irrelevant, so should he 
left at their defaults (255.25‘>.2'SS.()). 

• MacTCP usually requires a reboot after configuration 
changes, 0})enTranspori accepts tliese change.s on the fly, 

• You will have to address ,sc‘rver .software you mn on your local 
nuichine by ihe IP address you assigned in the TCP/IP 
configuration (192,0.1.2). For example, a weh server would be 
addressed usmg die uri iitip://192.0.1.2/" fuim your client 
softwartf. 

• If you want to use domain names instead of IP addresses, you 
will need to configua^ domain names in your TCP ‘‘hosts'' file. 
Tliis file is found in your “System Folder". Instructions for 
setting Lii> the ho.sts file are contained in the default “hosts” 
file .supplied with MacTCP or OpenTratisport. 

This method is explained in detail at 

<http://www.nisto.com/mac/question/neiwork.html>. 

Crcini Nimfeid <ffrmtt@kagt.com> 


Want to share a tip with the community 
and get paid for it? Send it in to 
<mailto:tips@mactecli.com> 



^id usyouT tips or we'll itml! IwiBeHerliusEm/r on your tmhina' On the i^ber band, we migbl just pay you S25 for each tip we use, or S50 for Ttp oftbe 
Month. You can take your award in ^oods, subscripiions or liS$. Make sure any code compiles, and send tps (and where to mail your winnings) to oiirTips e- 
mail address at ii0mictech.com,. (Seepa^ 2 for our other addrsm.) 
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Room for 



APS Technologies has everyhing you need to store, archive, protect, backup, transprt and distribute your next kllbr applicotion. Below 
are just a few of our most popular prr^ucls, so give us o call. Call to order. Call for a free APS catalog. Call for information... Just call 
1-800-761-8133. If you work in a mixed-f^tform environment, we've still got you covered - with Mac, Pu and NT products. 


1 APS KfGH-PERFORIVIANCE ULTRA SCSI DRIVES I 

Model 

Descriplion 

a 

Int 

SR 2000 

Pro 

APS a 2000 

Quantum Tireball ST, TOTSMB, IIK 

M9S»* 

■219- 


■319“ 

APS Q 3000 

Ousutum fireball ST 3118MG. 5,4K 

239“ 

243” 

319- 

349* 

APS Q 4000 

Quantum fireball ST. 4T36MB. 5.4K 

299” 

313” 

389” 

itr 

APS Q 6400 

Quanium Fireball ST. G236MB. m 

389^ 

413” 

489” 

519* 

APS DOT 

Quamum AHbs IL 4341MB. 7200 rpm 


499^ 

569” 

sar 

APS 09000 

Quanlum Atlas 11.8682MB. 7200 ipm 


799” 

869” 

890” 

APS ST 3000 

Seagate S2272N, Z157MB. 7200 rpm 


379* 

448P 

479” 

APS ST 4300 

Seagate Barracuda. 434(IMB. 7200 rpm 


549r 

619- 

649” 

APS ST 4900 

Seagate Cheetah. 434BMe. 10000 rpm 


649” 

N/A 

749” 

APS ST 9000 

Seagate Barracuda, 8683MB. 7200 rpm 


799” 

060" 

899” 

APSST91DQ 

Seagate Cheetah. 8661MB. 10000 rpm 


TG29” 

m 


APS WD 2000 

Western Digitel Emerpnse, 7200 rpm 


379” 

449” 

479” 

APSWDA3D0 

WesEcm Digital Pitierprisa. 7^ rpm 


STT 

649” 

679" 

APS HfGH^PERFORMANCE ULTRA SCSI DRIVES 

Model 

Pescjiplien 



Full Height 

APS ST 23000 

Seagate Elite 23.22JQB, 5400 rpm 




n,799*‘ 

APS $723000 W 

Seagate Elite 23,22.1GB. 5400 rpm 




1.899^ 

APS ULTRA WIDE SCSI DRIVES 

Model 

Description 


Ini 

SR 2000 

Pro 

APSD43aOW 

Quantum Atlas II. 4341 MB. 7200 rpm 


■523” 

■589” 

*629" 

APSQOTW 

Quanlum Viking, 4345MB. 7200 rpm 


S89” 

6fi9” 

689” 

APSQ9000W 

Quanlurn Atlas fl. SG82MB. 7200 rpm 


BZ9* 

B99" 

929” 

APSST3000W 

Seagate 82272W. 2157MB. 7200 rpm 


423“ 

49gF 

529” 

APS ST 4300 W 

Seagate Barracuda, 4340MB. 7200 rpm 


579^ 

649” 

679” 

APS ST 4500 W 

Seagate Clieetati, 4348MB, 10,000 


889” 

m 

799r 

APSST9000W 

Seagate Barracuda. S6B3M0,7200 rpm 


829” 

B99r 

329” 

APS ST 9100 W 

Seagate CTieetab, 86S1MB, 10,000 rpm 


1J)73” 

1149” 

1179" 

APS WD 3000 W 

Western Digdal Enterprise, 7200 ipm 


393” 

469” 

499“ 

APSVU!)43aOW 

Western Digital Enterprise, 7200 rpm 


59r 

Bes” 

633” 

APS IDE DRIVES 

Medfll 

Destriptioit 




Internal 

APSQ3000 

Quantum Fireball ST. 31 ISMB. 5400 rpm 




H%r 

APS 84000 

Quantum fireball ST, 4136MB, 5400 rpm 




249" 

APS Q 6400 

Quardurn Fireball ST, B236MB. 5400 rpm 




mr 

APS RAID 

Model 

Do»cri 9 ti(Hi 




Internal 


APS POWERBOOK STORAGE 


Model 

Oeactiption 


Internal 

APS PawerBofik Drive 

(BM DUAA-}l(H0.1(»gMB.«»0tpni 



APS 12000 

liKhibg MK2I03MAV. ZKJMS. 4200 iw lOE 


?9i" 

APS REMOVABLE DRIVES 

Mnilcl 

Desciiplicn 

Int SRIBOO 

SR 2000 

APS SQ 5200 

SyOuesiEZlOO, imE 

N7A K/A 


APSJai 

{wHhlcarmdgeilGG 

JWA ■399" 

399” 

APSJ4^ 

fwilhoiit eartrMgel 

m ■Tsg” 

299* 

APS MO DRIVES 

Model 

Description r.. ^ 

SR 1000 SH20Q0 

Pro 

APS 2^ MO 

(with 1 cartridge) 217M0 ^ r 

■299” *365” 


APS54DM0 

FutttsiiM2Sl3A2fl< 

m 419” 

449*' 

APS2.6GBM0 

SonvSMO-F544,I4GB 

m 1,669” 

1,699” 

APS CD-ROM DRIVES 

Medel 

Desertptipn 


External 

APSCD32 

32X CD-ROM in Slimline Case 


1179W 

APS CD-R Pkts 

2X record^ read CD-R (Sony) 


379” 

APS CD-R Pre 

4X recnrdj^X read CP-R in Pro Enclosure 


529* 

APS CD-RW 

2X record/6X read CD-RW in Pro Enclosure 


, 529* 

APS CD-RW Pro 

4X record^ read CD-RW in Pro Enclosure 

YrU 

599” 

APSJaz/CD-R 

J SI S 2X re c ord/6X read GO-fl 

\J mr 

799” 

APS26ByC[>-RW 

Q 2l30DHard Drive & 2X recerd/SX read CD-RW 


-1 899” 

APSCD-HPro 

4X record/6X road CD-H in Full Htighi Enclosure 


^ 729® 

tAviitsbk in SH 200G Endosarg for m gdbitionaiSmJX} 

— ’ 1 


: 

APS TAPE BACKUP SYSTEMS 



Model 

Oescripiton 

imeifiel External 


APS HypertUC* 

APSHvperDAP 

APSHyp&rDA?' 

APSHvperDAriil 

APS0LT3fl 

APSDLT40 

APSDLT70 

APS AIT* ® 
APS DU 


Tmvan 4 CQUrter QIC 3095.8GB 

E1DS'20CJGB 

ProDDS-2DC,8GG 

Dos-soc, im 

DLT3W0.30GB 

DJ 4000.40GB 

DLT 7000.7050 

Ujr\ WmC. 50GB 

4MMDDE'2AutalDadflr/136GB 


APS ShoftSTack 
APS Hardware RAID 


Quantitm Ultra SCSI GGS/12Ge 
Quantum Ultra SCSI w(/5 - 4i0B 


7,909" 



7W 

1199” 

ISS^ 

6,999” 

3.199” 

4,899" 


Order celine nlelog, el www.apstc<h.iom 

Alum Pwphcfol kK. OitB -buidnF intodiA runB tfonsmb 

or Mkrretib d tfviqpKlIef 

BonannL bur nl q fotf 

• KJIroMn inerupqAJtjtiy; 

• fepatr Cf iipq u i piT iir WirninfK 

jiTJ iwH. or wyitacf Of 

tPpatpfjjJuLiyhu^i^tx 



^radkflJ-^ NNiirwy 
-MMonknjit^lq 
Jff»JWteliiiy iw 

muU^JiicdlthCiptiiq 
CtW^tT- 

• iqfed^qpmtin fur 
AtrrnarrM 

> ^fiUoT dbtu loifJtAjibrr und' 
tapf(Vpan(Y-MHYSft>t>tijf 
dqxnahg on tflf rW [VI 
wcori^ Mh(T|)fiteni 

* 

• Sbu rni^ ED KrinW 

nwrJwr htfut usifw gur Aimti. 

• AW tv iW.^|n^jiuif ftrtfi, 

•O fP9?/Afcncr ftvfjftwnf Inc. Jfesnred 

1 - 800-761 


mtiiM I 


Technologies 
APS Technologies 
6131 Deramus 
Kansas City, MO 64120 
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hyJessica Cotirtney 



Nisus Software and Casady 8l Greene form Strategic 
Alliance 

Nisus i^oftvviirc and Cas<idy & Grcffi software develo|X.Ts 
announced that they liave formed a Strategic Alliance and will 
begin to cross market and bundle selecied prcxlucts. Nisus has its 
offices in the Sun Diego Coniniiinity of Solanu Beach, CulilV)mia, 
and Casiidy ^ Greene has its offices in the Silicon Valley 
communily of Salinas, California. 

Nisus Wriler is still the only solution on the Macintosh Ibr 
multilingual needs and will now be available with Casady & 
Greene's Spreadsheet 2000 program. 

L(K>k for Nisus Software’s announcements alxjut Mathlielp 
and other new cross platform prcxlucLs. 

<http://www.nisus.com/> 

Tabasoit SendGraphic: On The Fly Web Gkaphjgs Buiidfr 

Tabasoft Sc^ntlGraphic LO is a tool that allows macinUxsh 
webmasters to build on the fly (and send on ifie web) dyruimic 
graphics from data emiiedtled in HTML. 

Usually graphics are static iitiages in your web site linked 
as "<1MG SRC...” HTML tags. Suppose that your graphics comes 
from dynamic data and that this data changes every day (or 
more). If you have static graphics you have to manually rebuild 
your graphics every tlay. With SendGraphic you can avthd this* 
In fact it builds graphics in real time so ihal they always match 
your data. Also, with .static tiafa, SenciGrajdjic: can be very 
useful wiien you have to buik! tnaoy graphics and you don’t 
want to do it nianuatly. 

.ScMidCraphic can be u.se<i in very different situations. You 
may wunl to use SendGraphic as a WSAPl I HIT Server plug-in 
or as an HTl'P Server ACGI. SendGmphic requires a Power 
Macintosh, system 7 cjr later with QuickTime. 

A full version of SendCrajdiit' is now availalile for download 
at <http://tabasoft.andtel.it/TABASOFT/SendGraphic.html>. 
<http://tabasoft.ancileLit> 

Roundaboitt Logic, Inc> ls the New Plibusher of 
Nodester and Widgeitzer, QijicikI’ime VR Tcxils 

Roundabout Logic, Inc. announced that il is now the official 
pulxlisher of the weibknown QuickTime VR UkjIs, Nodester and 
Widgetizcr Both these Macintosh-only applications, formerly 
published by Panimation, Inc., are available from KouadalKml 
Logic, Inc, of Winter Sjmngs. Florida, as of Febniary 1, 1998. 

By Mart:h k 1998, Roundalxmt Logic will ship the latest 
updittes of Nodester and Widgetizer on CD with an entirely 
new l<M)k to the packaging. And for tJtc first time, the prcxJoci 
line will lie available from resellers wwldwlde (previously they 
were sold direci only). 


Nodester, the renowned rapid panoramic editor for 
QuickTime VR, first got national attention when it was included 
in Guy Kawasaki's address during the keynotes at Macw'orld 
Expo Boston in August of 1997 as one of his picks for the ten 
most exciting new' Macintosh applications for 1997. Since then 
it has gained notoriety from mt^si of the world's Macintosh 
press and has Ix'en deemed outstanding in many comparative 
pr<Klua reviews as well. 

Widgetizer is the iimovaiive rapid object editor for 
QuickTime VR (QTVR). Witli fciiures such as defliial>le ht)i 
spots, aistoni IxickgroimcLs, fntme-based animation and sound 
integration, Widgetizer provitles the most comprehensive objea 
creation IcKilset on the market. Both Nodester and Widgetizer 
export QuickTime VR l.O and 2.0. 

Apple Gompuler, Inc. developed Quit:kTime VR and has 
vigorou.sly supported its adoption as an industry* standard. 
With Apple's recent beta release of QuickTime 3-0, QuickTime 
VR v2.1 and streaming QuiekTime Plug-1 n v2.0, that standard 
has !>een achieved. QuickTime VR is an exicnsion of Apple's 
basic QuickTime technology and suppons two different types 
of views, QTVR panorama movte.s and QTVR object movies. 
Panoramic editors^ like Nodester, pnxluce movies which look 
out from a center or luxlal point, allowing die viewer to to 
simulate Uirning and viewing 360 degrees around a panoramic 
scene. Wklgelizer, a rapid object editor, generates object 
movies which kmk in ai a center point or plane, simulating the 
effeei of holding an object in the hand and turning it around 
to sec all sitles, top and l)oLtom. QuickTime VR Ls an 
innovative enaliling technology for elettronic commerce. 
Usually implemented as a photo-realistic or 31> rendered 
virtual reality, QTVR is finding tis way into markcis such as 
product catalogs, real estate, automobiles, museunis, 
cdiicarion, travel industry, etc. 

<http://www.roundaboullogic.com> 

Metrowekks Siiii*s New CodeWarrkir 1Yw>ls for 3Com 
PaLMPIIjOT ORGANiZliR AND IBM WOKKPaU PC COMPANION 

MeirtJwerks Inc. announced that they have begun 
shipping Release 4 of CodeWarrior for Palm CJS, the latest 
version of the comf>anyis popular set of development tools 
for building Palm Computing platform applications for the 
3Com PalniFiloi Organizer, IBM WorkPad PC Companion, and 
Franklin Day Planner T'he Palm Crunpuiing platform Ls an 
tjpen architecture consisting of the rerLTcnce hardware 
de.sign. Palm OS, llotSync conduit data synclironization 
technology, platform component tools, and software interface 
capabilities to support hardware add-ons. 
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Apple Computer, Inc. 

announces the 1998 

Worldwide Developers Conference 


May 11 -15,1998 

at the 

San Jose Convention Center 
San Jose, California 


Register after March 1,1998 by visiting 
Developer World at 

http :/Avww. devworld. apple .com 








Code Warrior for Palm OS is a tightly integrated 
development environment complete with editor, project 
manager, C/C++ compiler, source- and amnnljly-leve] debugger. 
direct-to-devk:e clel>ugger, stand-alone assembler GUI layout 
tools, and linker. It allows developers to take advantage of the 
enhanced TCP/IF support in the Palm OS 2.0 and design new 
applications to quickly and easily s^mchronize Palm OS data 
over coq>orate intrancLs and in-hoase networks. 
<http://www.metrowerk5,com> 

BliKKJiliiY SOFtWARE DESIGN INC. LICENSES JAVA APPLlGVflON 
Enmronmhn^i, BrinciS Java Tt> Popitiar Internet Service 
Provider Platform 

Berkeley Software Design Inc. (BSDl). has licensed the java 
Application Environnienl UAH) from Sun Microsystems to 
include in upcoming releases of BSDI Internet Server and 
e/BSD, the embedded systems technology for develt^pers of 
network appliances. 

Specifics of the Agreement 

RSDt joins a large numlier of Java technology licensees in 
embracing tlie JAE, Wiih this license, BSDI has access to 
JavaSoft's complete application cxeaiiion environment, including 
the Java Virtual Machine and all required class libraries. 

By virtue of ihe licensing arrangement with Sun, BSDI will 
provide its users and development partners a high degree of 
technical support, and plans to register their products in the 
Java Solutions Guide, as well as support Sun's Java Select 
Program for developers. 

The A)]ix:al of the Java Platform The Java platform is 
important to open computing, and as such it has become a 
popular environment for developing network management 
utilities, Wei? pages, and other objea-oriented appIication.s. 
Developers are adopting the Java language I’jentuse they can 
reuse software components across applications to economically 
get their products to more markets faster. Availability and Pricing 
Java will Ixr included in an upcoming BSDi Internet Server 
release in summer 199B. It will lx; availal)lc to network appliance 
tlevelojx-'rs using e/BSD technology in the same lime frame. 
<http://www.bsdi.com> 

Gixtcose Declares War on InmXtHjt wntt Reitase t>F 
Data Hammer 1,5 

Glucose Developmern Corporation today announced the 
immediate availability of Data Hammer T5, a major upgrade of 
iLs automatic text summariziition device for tlie MacinKxsh. 

A p<jwerful new text summarization engine, visual query 
execution, and round-trip web publishing top the list of 
features in this release. 

In adiltiton to the newspaper-style headlines that versjtm 
1.0 generated. Data Hammer 1.5 uses a new .summarization 
engine to extract a bulieted list of major topics from each 
sectif)n (jf a document. 


Users can also search for words or phrases and see a 
colored map of where litey txcur tliroughoui a dexurnent. 

In addition, round-trip web publishing means that any w^eb 
page can now be fetched, summarized, and saved as HTML all 
from within Data Hammer. 

<http://www.glu,com> 

New EthfrFefk v,3,5 for Macintosh 
The AG GroLi[), Inc. sliippcd ilie new version 55 of 
EtherPeek for Macintosh, an tipgrade to its popular 3.1 version. 
The award-winning Kihernet network and protcxol analyzer 
adds a new Summary Siatistics window for baselining and 
monitoring key traffic statistics to its rich set of capabilities. Key 
features of the software incliKle real-time and post-capture 
packet filtering. Plug-ins Fc?r expert packet aniily.sis, powerful 
decoding with support for all major protcxol suites (including 
IP, AppleTalk, Netware IPX/SPX, NetBEUI, NetBIOS, DECnei, 
SMB, OSl TARP and more), ProtoSpecs? technology for fine 
delineation of packet type, simple “Make Kilter" command for 
address, protocol and offset filtering creation/mexiifiotion, 
real-time utilization statistics for node, protocol, and filtered 
packet iTioniioring, HTMl. traffic stati.stics output, enhanced 
protocol definitions, and nunc. 

<http://www.aggroup.com/> 

Tangent Systems Ann()1]nc:es HdildSim 2,0 is Now 
Shipping and Rfadv for Download 
'I'angent Systems announced iliai it is now sliipping BuildSlin 
2.0 for the P(?wer Maemtash and Macintosh Computers. BuildSim 
2.0 represents a major teclmical upgnide. Besides the produaivity' 
tools, increased simulation speed and moa; capable simulation 
building blocks, Ls the ccxle base is now setup for a port to 
Wind(?ws 95. The company is alscj examining the option of 
jumping directly to a pure Java version of the application. 

BuildSim 2.0 Provides an Integrated Development 
Environment for Simulation and Control System Development: 

Developers will enjoy how^ easOy systems can be modeled, 
simulated and tested. With the inlcgrated automatic ccxle 
generator in the Platinum Edition, BuildSim Projccis can lx 
syntliesized in C++ or java for embedded system control, 
leveraging the growing internet infra.stnicture for simulation 
and distributed process control. With RuikLSim, Tangent 
Systems is one of the early entrants into the field of internet 
enabled disiributed process control and monitoring systems. 
The Java code generator tool will allow the synthesis of rolxj- 
controllers diat can then lx? compiled and deployed using U)ols 
already in the field. Complex dynamic mcxiels and control 
systems can simulated and data collected anti plotted. BuildSim 
has been designed to make tinkering" in the 
mrideling/simiilation worki easy. On top of llial, several 
pnxlucliviiy uxils have been carefully designed to make it a 
truly unique and powerful application for developing and 
deploying simulations and process control systems. 
<http://www.tangentsys.com> 
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If you want to be in the know, then you 
need every article published in the first 
12 years of MacTech® Magazine and 
Apple’s develop™ issues 1-29! 



,.An THINK Reference"'formati 


So hurry, pick up the phone, fire up 
the e-mail, launch that fax machine, 
or simply drop by our web site and 
order yourself this new release of 
the MacTech* CD-ROM. 


• Almost 1600 articles from all 139 issues of 
MacTech Magazine (1984-1996) 


• Includes Apple develop issues 1-29 

• Improved hypertext, improved indices, and a new TIIINK 
Reference Viewer — for lightning quick access! 


• New hyperlinks between articles 

• 100-t- MB of source code — use them in your applications, with no royalties! 


• Full version of THINK Reference — the original online guide to Inside 
Macintosh, Vols. I-VI 


• 80MB of FrameWorks/SFA arcliives and the most complete set of Frameworks 
archives known 


• Sprocket™ I MacTech's tiny framework that compiles quickly and supports 
System 7.5 features 

• 'File best threads from the Mac programmer newsgroups plus thousands 
of notes, tips, snippets, and gotchas 

• Popular tools that Mac programmers use to Increase their productivity and 
much more! 



Web Site: http//www.devdepot.com • E-mail: orders@devdepot.com 

Phone: 800-MACDEV-l • Outside tlie U.S. & Canada; 805-494-9797 • Fax: 805494-9798 


MacTech is a regislered trademark of Xplain Corporation. MaoDew*!, THINK Floferericet DevoEoper Depot, Sprocket, JavaTech, WebTech, BeTed), and the MacTutorlMan 
aoe trademarks of Xplain Corporation. Other trademarks and copyrights appearing in this printing or software remain the property tjf their respective holders. 



THE 

CLASSIFIEDS 



The Law Office of Bradley M. Sniderman 

California Lawyer focusing on Intellectual Property, 
Corporate^ Commercial and Contract law, as well as 
Wills and Trusts. 

If you are looking to protect your software with 
Copyright or Trademark protection, or if you need help 
establishing or maintaining your business, please give 
me a call or an e-mail. Reasonable fees. 

( 310 ) 553-4054 
Brad@Sntdernian.com 


Visit MacTech* Magazine’s Web site! 

http://www.mactech.conn 


Professional Software Developers 

Looking for eareef opportunities? 
Check out our website! 

Nationw'ide Service *’ 
Employment Assistance 
Resume Help 
Marketability Assessment 
Never a fee 

Scientific Placement, Inc. 

800-231 -5920 800-757-9003 (Fax) 

das@scientific.com 



The fastest, cost effective way to get product off your shelves. 

For information: • Voice: 805/494-9797 • Fax: 805/494-9798 • E-mail: venclor_relations@devdepot.com 
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Aladdin Know^kdge Systems lid.5 
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APS Technologies...71 
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Creative Solutions. 37 
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Digital Technologies intemationai.21 
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Dear develop readers, 


Since May of last year, Apple and MacTech have delivered valuable programming information and technical 
articles to you in tlie dsi)ekp section of Mac'Ikh Magazine. Some of the past year’s highliglits include: 


• Introducing PuppetTime 

• My First Yellow Box Application 

• Itektop Printing Reveled 

• Copy Protection and Serial Number 

• Calling CFM Code from Classic 68K Code 

We intend to continue providing you witli lliis type of high-quality technical information, but we no 
longer plan to do so under the (im}eU)p name. In tlie future, you can continue to expect to find tlie 
same focused, in-depth, Apple-authored articles like tliose above interspersed throughout MacTech 
Magazine, instead of under a separate devdop section. 


Of course, you will also find electronic articles, as well as other technical solutions, source code, and 
vital programming ideas on Apple platforms and technologies on Apple’s Developer World web site at 
<http://www.devworld.apple.com> and on the Apple Developer CD Series which is available to Apple’s 
Developer Program members. 


At botli Apple and MacTech, the goal is to make sure lliat you get the very l)est technical infonnation, 
when you need it, and how you need it. 


Worldwide Developer Relations MacTech Magazine 

j^)l}le Comlmter, Inc. XlMn Corporation 


Apple Computer, Inc. 
t Infinite l^oop 

Cupenino, Cidirornia 9501^-2084 

(408)996-1010 

(408) 996-0275 





Developer Depot PO Box 5200 Westlake Village CA 91559-5200 
800/MACDEV-l • Outside the U.S. & Canada; 805/494-9797 • Fax; 805/494-9798 
E-mail: orders@devdepot.com • Web Site; http://www.devdepot.com 
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1 the Dev Depot specials 
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books & utiliHes 
nto contact file 


Developor 

gf prioritize project 

□ Pick op new f 

□ Check out all th< 

□ Tell the gang ab 

□ Slock up on the 

□ Enter Dev Depo^ 

Developer Depot 
PO Box 5200 oi^ 

Westlake Village, C A 

Voices * 00 /N»ACDEV-l 
Outside US/Conados 805 
Foxt 805/494-^98 

E-mail: orders@devdepot 
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******* Digitiil IniajJing Technolof'y 





Get the 

QuickTime VR 
Authoring Studio 



for only 

$ 299 .“ 


When you purchase the 
KiWi+, Magellan QC or 
QuickPan Magnum 
By 



See page 16 for details 



06 


TOOLS. LIBS 
& UTILITIES 


12 


INTEIINET 

llELilTEB 


14 


SCIUPTING 


15 


10 


m 


m 



20 


ACCESSORIES 


21 


BOOKS & 
REFERENf:E 





rtHr 

rhdlH 


/ 

^ Feel 
about 





Order Tbil'hec 
IOO>ilUCDEV-1 


inO«!2Btl) 


Developer Depot 30 Money Back, Price and 
Saiisfactiott Guarantee 

Developer Depot products sue sold with a .30 Day morK -7 hark guarantee on 
user .satLsfaoicjn. lower pikes and againsl defects. If. for any reason, you are 
not satisfted or find the same product at a lower price wiihin 3fi days, please 
call CuMtrmer Service at H(X)-MACDHV-1 and request a Reiuni MercliandLse 
AudK>iT2aiion (RMA) number to get a foil refund or the diFfcreoce in price 
(where applioilrleJ* Yt>u must return undamaged pnxluct al your ex.r>en,He, 
including all Its original packaging, documentation and !l>e blank warranty 


card if applicable. Developer Depot svill replace defective product upon 
receipt of the dcfcctrve merrhandise. Please rememl>er to back up your data 
before insiallaUon of any new Iiardware, software, or periphemU; wc cannot 
be responsible for any lost data. Policies, item availability, and prices are sub¬ 
ject to change wtihoui notice, 'llie price in efTecl when we receive your otder 
will be the price that you are diatgcd. are raw rcspt>n.sible for any ty|x> 
graphical errors in this or any oilier c'aialog. nor for any misstatenicnts from 
any vendt>r. Purchase orders are not accx'ptr^ without prior appnwal, Gall for 
m<irt? information. 


Stuff OUT kwycr made uis write. 

IlevelfjptT JVpM Ijukr-H nt) cjtlirr wim-iiairs. All otlieT warrantie'i, eirber expressed or intplk'd. iitdiiding the implied warranty of menhuinialiility :mil Itinew ffw a juntk iiUir purfM^Ne 
arc disclaiiriea Developer Dep<it shall rwH be ilibk- for any tlircit. spe^tif irK’itlrni,il cir c<inKei|urTitiHil daniaK^ induding lost profits, from any ckrlay in delivery, or for any^tstm- 
al in|ury arifiiiiiji frf?m trie use of any product sold tlifough’Developer Depot. The limit of direct damages, if any. iihall nta exceeti die [niit'hase piiiv tjf the product.© 19W Xplaiii 
Corporation. An rigiii.s rest;rveti. Any nnatithorii^ed duplication is in violation of federal laws. Developer Ekpot is a regtsrered trademark oi’Xplsiin CtirporaUon, All priKluti names in 
diis catalog are the trademarks of their respective htik^rs. 

© 1997 Xplaln Qirponrikjn. All rights re4serv<xJ Any uriauiltori/ed du[T[lcration is in violation of federal laws. fX'veloper I’Jepot is a trademark of Xplain OLjrpfsration. Alt fmKluei names 
in this oitaloguc are trademarks or registered tradenmb; of their respect ivo lioklers 


TABLE OF CONTENTS 
























]>E^lSLOPMENT EmnillONMENTS 



fA 


metrowerks 


CodeWarrior for 
PalmPilot 
Release 4 

by Metrowerks 

CodeWarrior for PalmPilot is 
the first complete set of tools 
which enables you to develop 
for the U.S, Robotics PalmPilot 
connected organizer, from the comfort of your PC or Macintosh 
computer. All the tools you need are included: the award¬ 
winning CodeWarrior IDE. compiler, linker, source-level 
debugger, GUI builder, and other tools, plus online 
documentation and reference materials. Includes one free 
product update and free technical support with registration. 
(SCWPALM) Our Price $369 
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: Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 



CodeWairior 
Latitude 

by Metrowerks 

Don’t throw away the 
investment you have made 
in your Mac OS application! 

With the new DR2 release 
of CodeWarrior Latitude, you 
can now port your Mac OS 
application to Rhapsody, as 
well as Silicon Graphics IRIX 
and Sun Solaris. At the 
heart of Latitude is a set of shared libraries which perfonns the 
functions of the Macintosh API. You recompile your Mac OS source 
code, linking it with the Latitude libraries to produce a native 
application. As the Rhapsody API evolves, so will Latitude. 
Registered users of CodeWarrior Latitude will receive all developer 
releases, the first full release, plus one additional product update, 
to ensure that you have access to the most up-to-date Rhapsody 
porting tools available. 

(SCWLAD Our Price $399 


Be 

OS 


CodeWarrior 
for BeOS 3 

by Metrowerks 



• Start programming for the new, innovative Be Operating 
System peOS) with complete set of Codewarrior tools 

• BeOS-native Integrated Development Environment 0DE) with all 
the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax color 
and styling, and a source-level debugger 

• BeOS header and libraries, complete documentation, useful 
C++ classes, and sample code 

• Now includes Java support 

• The BeOS Preview Release allows you to run and program for 
the BeOS on a 603 or 604 PCI based PowerMac 

(SCWFB) Our Price $299 



MW Visual 
SourceSafe 
Release 5 

by Metrowerks 

• Source code control 
system, plug-in to the 
CodeWarrior IDE or 
stand-alone Client application 

• Compatible with Microsoft Visual SourceSafe version 5.0 

• Cross-platform support {Mac, Windows, UNIX) 

• Configuration management in excess of 4 bilfion files 

• Over 8,000 files and sub-projects in a single sub-project 

• Registered users receive one year of free technical support 
and one free update 

(SMWVSS) Our Price $499 
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Discover 
Programming 
Edition 

by Metrowerks 

Learn to program in 
C/C++/Java/Pascal 

. jll-featured programming product-not a “lite" edition 
Onitne books and tutorials 
Hosted on either Mac OS or Windows 95/NT 

AMrrlrvr Dr/^nmnnmlrun CriJ+ir\n rtffrtrc' nn 

,u.pmL.u,i u. prugfantniiiiy roois, oniine books 

instructionai materiais, ail at a great price, Whether you 
want to iearn the basics of programming or add a new language 
to your skill set, Discover Programming puts the information and 
tools you need at your fingertips: the award-winning, easy-to- 
use CodeWarrior integrated Development Environment (IDE), 
four of the most popular programming languages, online books, 
online tutorials, sample source code and free technical support 
(with your registration), Discover what you can learn with 
krdeWarrior, buy your copy today! 

PED) Our Price $79 


Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortran combines native F90, VAX compatible F77, and 
C/C+-H compilers into a single, easy to use environment. All compilers 
are link compatible and operate through a common Interface. 

• Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and Illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory allocation and new control constructs 

• F90 is link compatible with Absoft F77, C+-t-, MrC and 
CodeWarrior 

• It Is fully compatible with Toolbox, MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 



Macintosh Common Lisp 4.0 

by Digitooi, Inc. 

Macintosh Common Lisp provides users 
with a rich set of object-oriented dynamic 
language features making it especially 
weli-suited for rapid prototyping, custom 
development for business and education, 
scientific and engineering applications, and academic research. 


• Power PC native environment & compiler, full Macintosh support 







CodeWarrior 
Professionai Reiease 2 

by Metrowerks 

• Includes Windows 95/NT and Mac 
OS versions of the CodeWarrior IDE 

• Supports C, C-f-!-, Java and Pascal 

• Develop for Windows 95/NT on x86 and Mac OS on 68K/PowerPC 

• V2 Project Manager supports multiple open projects, subprojects, 
multiple targets per project, and threaded execution 

• Support for JDK 1,1,3 in CodeWarrior Java 

More platforms, more languages, more options: CodeWarrior 
Professional is designed to give you the tools you need for serious, 
industrial-strength programming, CodeWarrior Professional is the 
only Integrated Development Environment (IDE) in which you can 
edit, oimpile and debug C, C-l-^, Java and Pascal programs for 
multiple target processors and operating systems. CodeWarrior's 
compilers produce fast, highly optimized code for Windows 95/I\rT 
running on x86, or Mac OS running on 68K or PowerPC processors. 
CodeWarrior Professional features ttie CodeWarrior IDE Version 2, 
The revamped Project Manager supports multiple projects open 
simultaneously, multiple targets per project, and threaded execution, 
and it's significantly faster. CodeWarrior Professional also includes 
online books, documentation, and reference materials, as well as 
tutorials and sample code. We support 
your development efforts with one free update and free world- 
class technical support for a year with registration. 

(SCWPR02) Our Price $449 


BeOS Preview 
Release 2 

by Be, Inc. 

As the Internet spreads and 
electronic media becomes more 
prevalent, the high-performance 
needs of digital content design and 
the complex, aging architectures of 
current mainstream operating 
systems are coming into conflict. The BeOS is the first operating 
system designed to unlock the door to much more powerful 
personal computers, and extract more performance from the 
systems we use today. 

(SBEOS) Our Price $49 



• CLOS, the standard Common Lisp object system 

• Interactive dynamic environment, multiple processes 

• Automatic memory management and self-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiles with Common Lisp industry standard and smart 
programmable tools, 110-h mb of user contributed code 

• Complete on-line documentation (manual sold separately) 

• Software license and registration card 
(SMCLISP) Our Price $675 


Web site: http://www.devdepot.com • E-mail: orders@devdepot,com 
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Visual Cafe for Java 
Professional 
Development Edition 

by Symantec 

• Powerful Java and JavaBeans IDE 
with Plug-and-Play JavaBeans 
functionality 

100-r Professional. Reusable JavaBeans Components with 
Source Code 

Full JDK 1,1 Support via MRJ 2.0 
Latest Java Foundation Class (JFC) Library 
Comprehensive source editor with color coding and keyword 
highlighting 

On-the-fly Class reusability 

Turn Auto Code Generation On/Off Environment (RRAD On/Off) 
Powerful debugging Tools including debugging in any 
application mnning MRJ 2.0 and breakpoint view 
Netscape communicator 4.0 
Full featured Visual Page HTML Authoring Tool 
(SVCJAVA) Our Price $299 


Order Toll-free 
SOO-MACDEV-l 


|8(1W22-33811 





MkUnux: Microkernel Linux 
for the Power Macintosh 

by Prime Time Freeware 

MkLinux is a native port of Mach 3 and the 
Linux 2.0 kernel, complemented by 
hundreds of commands from BSD, GNU, and 
X11. It runs on most (NuBus and PCI bus) 
Power Macintosh systems: Performa. 
PowerBook, and multiprocessor ports are currently under 
development. 

MkLinux is robust, powerful, freely distributable, and source code 
compatible with most other Linux systems, it provides a full suite of 
development tools, support for AppleTalk, HFS, and Objective-C, and 
access to a vast amount of free software. MkLinux is a great way to 
‘come up to speed" on Mach. UNIX, and Rhapsody. 

• MkLinux user community supports FTP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple spwisored reference release contains a wealth of 
introductory and reference material on Linux. Mach, NeXT, and the 
Power Macintosh 

• Includes free 3.0 upgrade 
(BMKLINUX) Our Price $49 
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Isiial Cafe for Java 
Database Development 
Edition 

by Symantec 

• RIeMaker Pro and BlueWorld Lasso 
triaiware versions 

• 100+ Database aware JavaBeans 

Sybase SOL 

• Anywhere server-side database with development and runtime 
engines for Wln95/NT 

• DbANYWHERE server-side server 100% JDBC middleware 
with native drivers for Informix. Sybase, Oracle and Microsoft 
SQL server 

• Support for over 30+ databases through ODBC 

• Swift and scalable data access with dbANYWHERE’s true three 
tier architecture 

• Netscape Fast Track Web Server (Win 95) 

• Netscape Communicator 4.0 
(SVCJDB) Our Price $499 


VIP-BASIC: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can create full-featured, stand-alone 
Macintosh and Power Macintosh applications in standard BASIC code! 
VIP-BASlC 2.0 is the fastest vray to program your Macintosh. 

• Rapid application development environment virith application 
framework, mix and match: ViP-BASIC high-level subprograms 

• Import pre-existing BASIC code: automatically integrate BASIC 
code, export C Code for compiling: automatically convert your 
BASIC code to C for compilation with Metrowerks' CodeWarrior 
(SVIPBASIC) Our Price $195 

VIP-C: 

Visual Interactive 
Programming in C 

by Mainstay 

Now you can create full-featured, stand¬ 
alone Macintosh and Power Macintosh applications in just minutes. 
VIP-C 2.0 is the first rapid application development system for 
creating complete Macintosh programs in standard ANSI C. 

• Includes powerful, tightly integrated visual debugger, Import pre¬ 
existing C code: automatically integrate C code with a current project 

• Includes full-featured mini database: (ltd to 32K) of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-free, multi-user database applications 

(SVIPC) Our Price $295 
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SmalltalkAgents for Macintosh 

by Quasar Knowledge Systems, Inc. 

• An Integrated Development Environment (IDE) based on OKS 
Smalltalk. 

• “Live" direct manipulation of your objecte 

• Dynamic, interactive and iterative development process 

• Easy and full access to the features of the Mac OS(tm) and Mac 
Toolbox 

• Link your non-Smalltalk code fragments with Code Fragment 
Manager (CFM) support 

• Cross-reference, access, view, and manipulate your code and 
objects with a sophisticated database for source code 
management 

• Includes an Application Delivery Toolkit(tm) (AOT) that allows you 
to create royalty-free, standalone, double-clickable applications 
(SSTA) Our Price $395 


///, ’^TENON 

//f/ INTERSYSTEMS 


CodeBuilder 

by Tenon Intersystems 

CodeBuilder is a powerful and unique Macintosh software 
development tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C. C-t-t-, 
Ohjective-C, Java. Ada, and Fortran development tools 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-axle debugger for Objective C, and 
C, C+-I-, Ada 95 and Fortran 77 

• Web & internet scripting tods: Perl, MacPerl, tel/tk, bash, di, and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) Our Price $149 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http;//www.devdepot.coni 


NS BASIC 3.6 
for the Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation 
of BASIC programming language 

• Runs entirely on the Newton - no 
host is required 

• Create files, access the built in 
input and output 

• Work directly on the Nevrton, or through a connected Mac/PC 
and keyboard 

• Get the BASIC Internet Tool, available at no charge to NS BASIC users 
from www.nsbasic.com 

• Release Notes with sample code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the 
Newton Internet Enabler. Also mns on MP1201s with NOS 2.0 that 
have full memory available 

• Write short programs to access News, mail and the web 
(SNSBASIC) Our Price $99 

ObjectMaster 
Professional Edition 

by Altura Software, Inc. 

Object Master is an innovative programming environment that 
provides all the necessary tools to write, organize, and navigate 
through source code. 

• Write code using the most robust source code editor available 
on the desktop 

• Organize source code into projects to quickly access and 
manipulate all files 

• Navigate through source code using intuitive graphical 
Browser windows 

(SOMPE) Our Price $399 



soups, and the serial port for 
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Here’S a list of all available products. For full product descriptions 
please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

LPA MacProlog Developers Edition 

SLPAD 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

495.00 

LS Fortran Pro 

SLSFORT 

595.00 

LS Fortran Plug-In 

SLSFPi 

199.00 

Mac FORTRAN II 

SF0RT2 

595.00 

Power MachTen-UNIX 

SM10PPC 

695.00 

Presenting Magic Cap 

BPRESMAGIC 

15.25 

Think Pascal 4.0 

SPASCAL 

165.00 



Web site: htfp://www.devclepot.com • E-mail: orders@devclepof.com 
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PowerKey Pro Model 200 

by Sophisticated Circuits 
PowerKey Pro Modei 200 lets you start 
up and shut down your Mac and up to 
five peripherals with a _ ___j, v^ ^i. 


single keystroke, Two 
groups of switched 
outlets let you control 
some peripherals 
separately, PowerKey 
also features phone 
ring startup which 
lets you access your 
Mac while on 
the road. 

Powerful scheduling 
features let you 
control your outlets with “hot keys" or 
perform tasks unattended. Start up your 
computer at any time of the day or night, 
open applications and run AppleScripts 
Of QuicKeys. Add the optional Server 
Restart Option and you can even restart 
crashed servers automatically! 

System Requirements: Mac with ADB 
port. System 7 or later. Telephone 
features require analog phone line, 
(HPKEY2) Our Price $99 



PowerKey Pro Model 600 

by Sophisticated Circuits 

PowerKey Pro Model 600 is “the world's 
smartest power strip!" Start up and shut down 
your Mac and 
peripherals with a single 
keystroke. Includes ^ 
individually-switched 
outlets, with manual 
switches and indicator 
lights. Powerful 
scheduling features let 
you control outlets with 
"hot keys” or perform 
tasks unattended. Start 
up your computer at any 
time of the day or night, 
open applications and run AppleScripts or 
Quid(eys. Complete telephone controllability 
lets you start up the computer, switch outlets 
or run complex events using custom touch- 
tone (xrmmands. For a limited time, Model 600 
includes the Server Restart Option. Restart 
crashed servers automatically! 

System Requirements: Mac with ADB port. 
System 7 or later. Telephone features require 
anaiog phone line. 

(HPKEY6) Our Price $199 
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Joy Explorer 

by AAA-i- Software 

Joy Explorer gets you started with 

Rhapsody programming quickly: 

• Step by step tutorial for implementing 
simple applications 

• Graphical application inspector for 
inspecting classes, instances, methods, 
and data structures inside any 
Rhapsody application. 

• Interactive sending of messages to 
objects 

• Extension to Rhapsody’s Interface 
Builder which permits 
Implementation of prototypes right 
within Interface Builder - no need to use 
any tools except Interface Builder; no 
need to compile and link, 

• Example programs with full source code, 
including source code for application 
inspector. 

(SJOYEX) Our Price $69 




SpotCheck 

by GenieWorks, LLC 

SpotCheck is a language-based editor that 
'‘knows" the Java language, it Is designed to 
help a Java programmer produce conect 
code without relying on confusing and 
untimely feedback from a compiler. 
Specifically, SpotCheck identifies syntax 
errors and semantic errors (undefined 
names, type mismatches, etc.) those errors 
normally returned by a compiler. This 
analysis is performed after each edit, giving 
the programmer immediate feedback on 
errors. ^tCheck provides a tKst of 
additional features. Including: 

• smart links to name declarations 

• cross-referenced Java APIs 

• editing with popup menus 

• interfaces to helper apps to compile & run 

• hierarchical project browsing 

• color-coded syntax 
jSCHK) Our Price $59 
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Joy Developer 

by AAA-i- Software 

Joy Developer is an essential tool for anyone serious about develr^ing for Rhapsody: 

• Rapid applioation development right within Rhapsody's Interfaoe Builder 

• Incremental extension of existing applications (test-flx-go) without any need to recompile, 
relink or restart the application 

• Turn Interface files into standalone applications that ruh on any Yellow Box platform simply 
by using the new “Save Nib As App" command in Interface Builder 

• Mix-and-matoh interpreted scripts and compiled code freely; anything you can do in 
compiled Objectfve-C and Java can be done in Joy - and more. 

• Full support for all Objective-C classes, typedefs, macros, data structures, exceptions, 
Tcl 8,0 commands and extensions, including byte-code compiler to boost performance 
(SJOYDB/j Our Price $399 


NetMinder Ethernet 

by Neon Software 

InH NetMinder Ethernet is a software-only protocol analyzer which 
ill^l captures and decodes a full range of Ethernet protocols including IP, 
AppleTalk, NetWare, NetBIOS and DECnet. Features include: 

• Sophisticated long-term monitoring with HTML output 
Intuitive and powerful filtering capabilities 
Automatic mapping of names to Ethernet, AppleTalk, and IP Addresses 
Rules-based engine for detecting unusual network conditions 
Customizable graphs for bandwidth utilization and packet rates 
(SNETMD) Our Price $715 
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Visual MacStandardBasic 3.0 

by ZCurve Software 

Visual MacStandardBasic is the new standard for creating both 

68K and Power Macintosh applications. 

• Applications can be visually created in minutes 

• Visual controls such as command buttons, text boxes, list 
boxes, radio buttons, check boxes, scrollbars, icons, pictures 
and timers can be created and modified instantly 

• Use color graphics, animations, movies, sounds and speech 
in your programs 

• Console text window option helps converting older BASIC 
source code from other platforms 

• Online tutcxial, manuals, sample projects get you programming quickly 

(SVMACSB) Our Price $29.95 


ac 

by Onyx Technology, Inc. 

High performance runtime stress testing for applications. 

• Tests include heap checks, purges, scrambles, 
handie/pointer validation, dispose/release checks, write to 
zero, de-reference zero as well as other tests like free 
memory invalidation and block bounds checking 

• Extremely user friendly - ideal for non-programmer testers 

• Also available in Japanese 
(SQC) Our Price $99 




Web Ware 

by BeachWare, Inc. 

The ultimate OTilection of clip media and templates for building your own 
Web Page. An incredible selection of Shockwave movies, animated GIFs, 
buttons, bullets, dividets, and sample HTML pages. There are literally 
thousands of graphical elements on this disc, all there to spice up your 
web page. In all, it's about 300 megabytes of creativity only a mouse-click away! System 
Requirements: PC - 486 or better with 8 MB RAM. Sound card, SuperVGA. CD-ROM drive. 
Macintosh - Color Mac with 8 MB RAM, CD-ROM drive. 

(SWEBW) Our Price $24 



SPOTLlQhT 


Spotlight 

by Onyx Technology, Inc. 

Spotlight Is a stand alone 
debugging aid that performs memory 
protection (arrays, heap accesses, outside 
your heap, low mem, etc), discipline checking 
on toolbox calls, and leaks detection. 

• Spotlight is sold on an annual subscription 
basis 

• The subOTption service provides all updates 

• Includes maintenance releases for one 
year after 

the initial purchase or renewal date. 
(SSPTLD Our Price $199 
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Apprentice 7 

by Celestin Company 

Apprentice 7 is a high-quality CD-ROM 
collection of over 600 megabytes of up-to- 
date source code, utilities, and info for Mac 
programmers. All of the source code and 
utilities are completely new or updated for 
this release. 

• Frontier 4.1, the highly-acclaimed 
scripting environment 

• More PowerPlant AND many more 
PowerPC samples 

• Cool new languages and environments 
added (Clean, Eiffel, F, Tcl-flt} 

• Hot new demos from leading Mac 
development companies 
(SAPPREffT) Our Price $35 


StoneTable 68K/PPC 

by StoneTablet Publishing 

StoneTable is a powerful and professional 
replacement for the List 
Manager used by developers worldwide. 
Version 3.0 is a new release with many 
improvements including better clipboard and 
drag/drop integration with other applications. 

• Available for use with CodeWarrior C & 
Pascal 

• Includes libraries for 68K (A4 & A5) aitd 
PowerPC 

• An LTable-like class is provided to 
incorporate StoneTable into the 
PowerPiant environment 
(SSTONEFA1) Our Price $199 



VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Stand-alone version control tool for ail 
sorts of projects (software 
development, documentation, design, 
CAD, publishing, etc.) 

• Smooth integration with Metrowerks 
CodeWarrior and BBEdit. 

• Simple and clear management of variants 
and revisions of entire projects (not only 
of single files) 

• Easy-to-use graphical project browser gives 
access to all versions that were ever stored. 


• Recording of the complete history (who 
made which changes when and why) 

• View differences between versions (not 
only for text files!) 

• Efficient delta storage of arbitrary files 
(text as well as non-text 

files) gains savings of 95 % and more 

• Administration of users with hierarchical 
access rights 

• Configurable local file locking (Finder flag 
or 'ckid' resource) 

• Scriptable. essential parts Powerf’C native 


Single license (SV000001) 

$229 

2 pack (SV00D002) 

$359 

5 pack (SVO0DO05) 

$799 

10 pack (SVOODOO10) 

$1369 

20pack(SVOODOO20) 

$2399 

Additional pricing available on 

request. 


SEE RELATED CATEGORY: Dev. Environments 
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ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C++ classes for integrating 
Internet e-mail in your applications 

• Helps you write software that can 
share mail with other leading e-mail 
products 

• Royalty-free MIME, SMTP, and POP3 APIs for Macintosh, 
Windows, and Unix 

• Gives you the most robust MiME parser and encoder available 

• Ideal for use In Internet and Intranet environments 

• Comes complete with samples with documented, reusable source 
code 

■ Free standard technical support 
(SOSMSDK) Our Price $495 



CodeBuilder //A ^TEHOH 

by Tenon Intersystems iNTEusysreMS 

CodeBuilder is a powerful and unique Macintosh software 

development tool for porting existing apps or developing new. 

advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development too! suite of C, C-h-, 
Objective-C, Java, Ada, and Fortran development tools. 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger tor Objective 0, and 
C, C++, Ada 95 and Fortran 77 

• Web & internet scripting tools; Perl, MacPerl, tcl/tk, bash, sh, 
andcsh 

• Supports Rhapsody kernel APIs and Rhapsot^ TCP sockets 
(SMIOCODEB) Our Price $149 


Guide Composer'" 1.2 

by StepUp Software 


STEP”” 

SOFTWARE 


• Create powerful Apple Guide help systems for any new or existing 
Macintosh application 

• Provides a WYSIWYG development environment: Guide content is 
developed in Guide windows 

• Design topics, phrases, and panels in the same format as the user 
will use them 

• Features are WYSIWYG interface. Topics, phrases, and 
hierarchical phrases, Coach marks, Fully-Integrated with Apple’s 
Guide Maker (distributed with Guide Composer), compiles scripts 
automatically, PtCTs in Panels, Generated Guide scripts are modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http://www.guideworks.com/ 

(SGCOMP) Our Price $99 


SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman’s 
AppleGulde Slarter Kit, Real World AppleGuide 



B-lfee HELPER 2.2 

by Magreeable Software 

• Inexpensive database engine 
for Macintosh programmers 
in C source code 

■ Uses contiguous fixed length 
blocks 

■ Expands the file as necessary and contracts tiles when 
possible 

• Inserts and deletes keys in one or more B-Trees 

■ Finds keys equal to, less than, or greater than a given value 
in a few hundredths of a second 

• Finds lists of records whose keys are equal to, less than, or 
greater than a given value or are in a range of values 
(SBTREE) Our Price $149 




BBEdit4.S 

by Bare Bones Software 

BBEdit 4.5 is a powerful, easy-to- 
leam text and HTML editor that 
I I developers and HTML 

BBEdit 4.5 1 authors the ability to build on its 
core functionality to suite their 
specific needs through its plug-in architecture and scripting 
capabilites. This new version includes: a visual table tool that 
speeds page and site development, contextual menu support for 
Mac OS 8, improved storage tor 'grep' patterns, scriptable HTML 
authoring preferences and more, ft still provides: unparalleled 
searching muscle with support for both 'grep' s^e and advanced 
literal searches, the ability to quickly compare differences 
between files or entire folders, integrated support for Symantec's 
IDE, Metrowerks CodeWarrior, TTIINK Reference 2.x, MPW 
Toolserver and most other environments and a heck of a lot more. 


(SBBEDm Our Price $119 
Also see Internet Related, page 12 


Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer "atoms" that let developers incorporate 
graphics, sounds, file compression and custom folder icons into 
installation scripts 

• Compression formats supported are Compact Pro & Diamond 
■ Each atom also available separately 

• Compression requires additional licensing 
(SINSTALL) Our Price $219 

ScriptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp's InstallerPack, Stufflt decompression, Compact 
Pro decompression, custom packages, splash screens, network 
installs, and resource installation 

(SSCRPTGEN) Our Price $169 
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BeSpecific 3 

(Tliinl in a series) 

by Adamation 

The best-selling BeSpecific CDROM series 
provides the best in BeOS 
shareware across a wide range of 
application areas, including: 

• Productivity programs • Latest source code 

• Programming tools • Graphics Games 

• Commercial demos 

Newsgroup archives (comp.sys.be) Developer mailing list (Be DevTalk) 
BeSpecific 3 is brimming with usefui BeOS Preview Release- 
compatible software. A “must have" companion for all users of the 
BeOS. 



Pilot Attache Disk 1 

Pilot AttacM 

B3 

(First in a regular series) 

by Adamation 



The Pilot Attachd CDROM, designed tor the 



popular US Robotics Palm Pilot organizer 
provides you the best in Pilot shareware. 



Extend your Pilot's capabilities across a 
wide range of application areas, including; 

• Personal productivity tools • Newsgroup information 

• Programming tools • Games 

• Utilities 

Fully tested, Pilot Attache's shareware treasure throve will help you 
get the most out of your Palm Pilot. When you travel with your Pilot, 
don't forget your Attach^. Pilot Attachd...your passport to success. 


(SPATCHE) Our Price 


Water's Edge Software 


Tools Plus libraries + 
framework 

by Water’s Edge Software 

Easily create compact, fast running, 
professional looking applications and plug-ins*. 
Tools Plus lets you create virtually any user 
interface element with a single routine, and it 
transparently provides a robust infrastructure to 
make all your pieces work together as an 
application. 

• Simplifies programming and thins source 
code 

• Automates all standard GUI elements 

• Thousands of extras, from floating palettes 
and tool bars to powerful picture buttons 

• Includes numerous 30 grayscale options 


• Over 1/2 MB of custom fonts, icons, 
cursors, and other resources 

• Includes SuperCDEFs world-class controls 
(an $89 value) free 

(STOOLCW) Our Price $249 

CodeWarrior Gold 

(C/C++& Pascal, 68K& PPG) 

(STOOLCWB) Our Price $199 
CodeWarrior Bronze (C/C++ & Pascal. 68K) 

(STOOLSYMT) Our Price $199 
Symantec (THINK) C/C++ and THINK 
Pascal (68K) 

(STOOLSYM) Our Price $149 
Symantec ffHINK) C/C++ (68K) 

(STOOLPAS) Our Price $149 
THINK Pascal (68K) 

'CodeWarrior required to write plug-ins 


AppMaker 

by Bowers Development 

• Develop the user interface for a Macintosh application 
using the original interface builder 

• Just point and click to design your application 

• Creates resources and generates excellent source code 

• Supports most development environments including 
Metrowerks, Symantec, or MPW; C, C++, or Pascal; 
procedural or object-oriented, using PowerPlant, TCL, 
or MacApp 

• The generated code uses the Universal Headers to provide PowerMac compatibility 

• Great tool for beginners to learn object-oriented and Macintosh Toolbox programming 
techniques 

• Includes one-year subscription on CD and hardcopy dxumentation 
(SAPPMAKE) Our Price $199 
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TestWack-Bug Itacking 
the Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test 
configurations, users, and more 

• Includes notifications, security, a 
powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, 
documentations staff, and project 
managers together to ensure all bugs 
are identified, fixed, and documented 

■ Eliminates the need to build custom 
bug tracking solutions using general 
purpose database tools 

• Supports single- and multi-user bug 
databases (additional licenses 
required to use multi-user features) 
(STETR) Our Price $129 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Check out our Web site! 

’ Full product descriptions • Hundreds of more products 

http://www.devdepot.com 



Memory Mine 

by Adianta, Inc. 

• Monitor heaps, Identify probiems such as memory ieaks, and 
stress test appiications 

• Active status of memory in a heap is sampled on the fly: 
allocation in non-reiocatable (Ptr), relocatable (Handle) and free 
space is shown, as are heap corruption, fragmentation, and more 

• Allocate, Purge, Compact, and Zap memory lets users stress test 
all or part of a program 

(SMEMMINE) Our Price $99 


SuperAnalyst 

by SuperSoft 

SuperAnalyst is an easy- 
to-use data analysis and 
plotting application 
written specifically for 
the Apple Macintosh 
computer and PowerPC. 

It provides a wide range 
of X-Y plotting and analysis capabilities at a click of the mouse. It 
is easy to use and provides interactive control of the appearance of 
almost every characteristic of your plot. You can overlay multiple 
plots on the same graph, and the number of points is limited only 
by the memory of you computer. 

(SSANAL) Our Price $99 


SuperPlotPRO 

by SuperSoft 

• Plotting data from your program was never easier 

• A Plotting and Chart Library callable from Fortran. Pascal, and C 

• Plot Types: Scatter, log-log, x semi-tog, y semi-log, Ddouble Y. 
cross, line, line w/ symbols, bar, stacked bar, column, stacked 
column, area, pie, polar 

(SSPLOTPRO) Our Price $295 


Future BASIC II 

by Staz Software 

FutureBASIC II is the award 
winning leader in Macintosh BASIC 
programming. 

• Source level debugger and Interactive compiler/editor 

• Multi-file Project manager and Multi file find and replace 

• Super fast compilation, 32 bit clean, and System 7.x savvy 

• QuickBASIC converter 

• Getting Started manual with over 500 example files 

• Full support of standard BASIC 
(SFBASIC2) Our Price $229 



AG Author 

by Lakewood Software 

AG Auttior 1.0 is a full-featured Apple Guide authoring tool with 
fully customizable project template. The following features are 
unique to AG Author: 

• Support tor styled, colored, & hot text 

• Fully customizable project template 

• Flexible compile options 

• Find & replace tool for scripts 

• Multiple open projects 

• Flapid deployment of project globals 
(SAGA) Our Price $99 

SEE RELATED PRODUCTS: AppleGuide Complete. Danny Goodman's 
AppleGuide Starter Kit. Real World AppleGuide 


SoftPolisb CD-ROM 

by Bare Bones Software 

• The essential tool for software quality 
assurance on the Macintosh 

• Helps you identify inconsistencies with Apple’s user interface guidelines, 
misspelled words, missing resources, and other mistakes 

• Provides tools to put the finishing touches on software distribution 
packages prior to release 

• Works independently of any programming language or environment 

• Idead for sanity checking software throughout the development process 
(SSOFTPOL) Our price $99 
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Be Basics 

by BeatWare 

Be Basics is the first productivity suite to 
combine the essentiai toois you use 
everyday with the incredible power of the 
BeOS. Be Basics 

offers the BeOS developer the ability to: 

• Combine text, tables, graphs and pictures to create compelling 
documents 

• Work with multiple files simultaneously without degrading performance 

• View all layout, style and content changes as they happen 

• Import Microsoft Excel files 

• Plug-in third party graphs and filters 

Be Basics requires the BeOS, 16 MB of RAM, 2 MB available hard 
disk space and a 256-color display adapter. 

Price includes all major and minor upgrades through version 2.0 via 
electronic distribution. 



OpenGL for 
the Macintosh 

by Conix Graphics 



OpenGL is the premier 3D graphics library that allows software 
developers the ability to develop high-quality, interactive 2D and 3D 
graphics applications. OpenGL can perform the following wide range of 
functions which will enhance the development of all graphics software; 

• Geometric primitives (points, lines, and polygons) 

• RGBA or color index mode 

• Viewing and modeling transformations 

• Texture Mapping, Lighting, Shading and Z Buffering 

• Atmospheric Effects (fog, smoke, and haze) 

• Alpha Blending (transparency) 

• Antialiasing, Accumulation Buffer, Stencil Planes 

• Display list or immediate mode 

• Polynomial Evaluators (to support Non-uniform rational B-splines) 

■ Feedback, Selection, and Picking Raster primitives (bitmaps and 


(SBEBASIC) Our Price $69 


pixel rectangles) 

• Pixel Operations (storing, transforming, mapping, zooming) 



(SOPENGL) Our Price $389 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

Bee-one 

SBEEONE 

$139.00 

C*tree Plus® Database Handler 

SCTPDH 

$895.00 

Compllelt! 

SCOMPfT 

$149.00 

CPU Doubter 

SCPU2X 

$79.00 

DesignWorks 4.0 

SDWORKS 

$995.00 

dtF 

SDTF 

$695.00 

EtherPeek 

SEPEEK 

$745.00 

Fortran 77 SDK 

SF77 

$699.00 

ICONIX PowerTools-6 Pack 

S1CPP6 

$5,945.00 

ICONIX PowerTools-8 Pack 

S1CPP8 

$6,945.00 

ICONIX PowerTools-10 Pack 

SICPP10 

$7,845.00 

ICONIX PowerTools-AdaFlow 

SICADA 

$1,395.00 

ICONIX PowerTools-ASCII Bridge 

SiCASCII 

$1,395.00 

ICONIX PowerTools-CoCoPro 

SICCOCO 

$1,395.00 

ICONIX PowerTools-OataModeler 

SICDATAMOD 

$1,395.00 

ICONIX PowerTools-FastTask 

SICFASTTASK 

$1,395.00 

ICONIX PowerTools-FreeFlow 

SiCFREEFL 

$1,395.00 

ICONIX PowerTools-Object Modeler 

SICOBJMOD 

$1,395.00 

ICONIX PowerTools-PowerPDL 

SfCPOWER 

$1,395.00 

ICONIX PowerTools-QuickChart 

SICQUICKCH 

$1,395.00 

ICONIX PowerTools-SmartChart 

SICSMART 

$1,395.00 

ICONIX Training & Consulting 

TICONIX 

$2,945.00 

IMSL Math and Stat Library 

SiMSLSTAT 

$495.00 

Info-Mac X 

SINFOMAC10 

$39.00 

Ionizer Real-Time Spectral Reshaping Tool 

SIONIZER 

$800.00 

UveAccess™ 1 User Edition 

SLAUE 

$69.00 

UveAccess™' 1 Developer Edition 

SLJ^DE 

$99.00 

LIveCard 

SICARD 

$149.00 

U Profiler 

SUPROF 

$295.00 

MacA&D 6.0 

SiVIACADP 

$1,995.00 

MacFlow": Flowchart Design and Development 

SMACFLO 

$179.00 

Mac Source II 

SiyiACSOURCE 

$29.95 

Nisus Writer 5.0 

SNISUSW 

$220.00 

Plan & Track’”: Project Planning and Management 

spmm 

$179.00 

Phyla’”: Object-Oriented Database 

SPHYLA 

$179.00 

QUED/M 3.0 

SQUEDM 

$89.00 

r-tree R^ort Generator 

SRTFtG 

$445.00 

Spellswell Hus 2.1 

SSPELL 

$49.00 

SuperPlot 

SSPLOT 

$195.00 

Visual Caf6 

SVCAFEMAC 

$199.00 

VText 

SVTEXT 

$349.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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2.5 

By Blueworld **** ” 
Communtcations 

Lasso 2.5 is 6ie ultimate 
FileMaker Pro Web development 
tool for creating online stores, 

_ _ discussion groups and ottier 

N yygjj applications that can 

handle hundreds of thousands of 
hits per day. Over 50 new tags including math, string and 
variable allow unparralleled data handling capability. Create 
embedded operations with the inline command. Lasso Server 
edition supports multihoming and offers superior performance. 

Order Lasso today the award-winning tool that which sets the 
standard for Mac OS dynamic Web database publishing. 
•Multi-threaded performance 

• Supports CDML and LDML 

• Enhanced security for electronic commerce 

Product Code Our Price 


Usso 2.5 CGI/P!ug-ln (SLASPG) $499 
Lasso 2.5 Server (SLASSVR) $649 


ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C++ classes for integrating 
Internet e-mail in your applications 

• Helps you write software that can share 
mail with other leading e-mail products 

• Royalty-free MIME, SMTP, and POP3 APIs 
for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 

webAlias 1.0 

by Lakewood Software 
webAlias 1.0 is an 
integrated image map 
editor and anti-aliasing 
text tool for web and 
graphic designers. Use 
webAlias to create 
complete web sites, 
single web pages, and graphic content for multimedia and web 
design projects. webAlias integrates support for line, shape, free 
form, field and button objects. webAlias’ anti-aliasing features 
include support for embedded pictures and gradients in text, as well 
as multiple shadow and highlight effects. 

(SWEBALS) Our Price $129 




WebTen 

by Tenon 
Intersystems 

WebTen is an 
industrial-strength, 
high-performance 
Apache server for 
Power Macs. WebTen’s 
Web-based browser 
interface enables local 
or remote administration via your favorite browser. Since Apple’s NeXT 
acquistion, Tenon has extended their unique “UNIX virtual machine" 
technology to produce a set of "Rhapsody-Ready" internet 
applications. WebTen is the first offering in this series. 

• WebTen is the fastest Web server on Power Macintosh 

• Sustains up to 10,000 connections a minute, or over 10 million 
connections a day 

• Apache runs in Tenon’s multi-threaded, pre-emptive 
multitasking environment 

• Tenon's unique technology supports the widely acclaimed Apache 
Web server as a double-clickabie Macintosh application 
(SWEBTEN) Our Price $495 




BBE(m4.5 

by Bare Bones Software 
(SBBEDUl Our Price $119 

ALSO see Tools, Libraries and 
Utilities, page 8 
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HyperGuide 1.0 

by Lakewood Software 

HyperGuide 1.0 is a 
hybrid multimedia 
authoring tool and on¬ 
line documentation 
system for the 
Macintosh and World 
Wide Web. HyperGuide 
provides integrated 
searching, indexing and 

bookmarking features. Supported media elements include: rectangle 
and scrolling fields, lines and shape fills, most QuickTime-supported 
image formats, anti-aliased text and QuickTime VR movies. 
HyperGuide also includes an integrated screen capture utility and 
user-configurable slide show mode. 

(SHYPGUD) Our Price $149 
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PageCharmer 1.0 

by Mainstay 

PageCharmer is a set of customizable interactive applets that 
enhance web pages without writing a single line of HTML code. 
Whether the web site is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need. 

FEATURES: 

LiveG-Map, LiveT-Map, UveG-Button, LiveT-Button. LiveGT-Button, 
LiveG-Ticker, LiveT-Ticker, LiveG-Marquee, and LiveT-Marquee. 
(SPGCHRM) Our Price $99 


Rumpus 

by Maxum Development 

Maxum’s new. high* 
performance FTP server for 
the MacOS. Based on 
Maxum'sRushHourTCPAP implementation. Rumpus 1.0.1 offers 
the performance and reliability of high-end workstations with the 
ease of use. security, and flexibility of the Macintosh. 

• Simplified setup, with no need to configure AppleShare, File 
Sharing, or Users & Groups for simple anonymous FTP 

• Anonymous and/or secure server access, with separate 
security settings for anonymous vs. secure users 

• Automatic MacBi nary and Binhex encoding 

■ Complete logging, with separate anonymous and secure 
access logs, including anonymous user passwords 

• Up to 32 simultaneous connections 
(SRUMP) 0urPrtce$195 



Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the only Macintosh product that can turn your 

Macintosh into a complete Unix workstation. Based on 

BSD4.4 and the Mach kernel, MachTen brings the power 

of Unix to your desktop at an extremely attractive price point. 

MachTen enables you to: 

• Run a high speed internet server, complete with WWW. FTP, NFS, 
DNS and print service 

• Build a Mutihomed Web Server 

• Develop applications in a Unix development environment, replete 
with the acclaimed GNU development toolset 

• Program in Ada. C, C-r-r-, Pascal. Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, already ported for MachTen 
and available on our Ported Applications CD-ROM 

• Run Software.com Inc's acclaimed Post-Office mail transport service 
(SM10PPC) 0urPrice$695 



CGi Toolkit 

by Pictorius, Inc. 

The Pictorius CGi Toolkit is the fast and 
easy route to high performance CGIs and 
ACGIs for your Mac Web site. 

• Interactively develop CGIs while the 
web server, the CGI Toolkit and the browser are running on the 
same machine 

• Interactively develop, test and debug CGIs before compiling 

• Powerful debugger allows you to edit code, roll back, code and 
change input values while your ^plication is running 

• Fully object oriented so you can re-use your code 

• Automatic handling of Apple Events so you can concentrate on 
building functionality 

• Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 

(SCGITLKT) Our Price $149 



Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 


CODE OUR PRICE 


OOFILE Reporter Writer SOORW $499.00 

ScriptDemon SSDEMON $949.00 

WebSiphon SWSIPHON $495.00 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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TCP/IP Scripting Addition 

by Mango Tree Software 

• Award-winning AppleScript scripting 
addition 

• Allows you to write scripts using 
MacTCP^M conrmands in AppleScript” 

• Send e-mail or files through a script, 
check if users are logged on (via Fingerl, automate FTP, Gopher. 
NetNews, Telnet, and LPR, verify links in HTML documents, and 
quickly write many other TCP/IP client-server programs 

• Works with AppleScript, MacTCP 2.0.4 and Open Transport 
(STCP) Our Price $49 



9 

TCP/IP 

Soripting Addition 

ri*r ..T 


Scripter 2.0 

by Main Event Software 

For professionals, for novices, for 
webmasters, for solutions providers, 
there's only one serious choice. Scripted 
• Scripter and FaceSpan work together: 
one click opens your FaceSpan script in 
Scripter. another sends it back 

• Debug handlers without modifying your scripts using the Call 
Box 

• Applet simulation, live editing. Object map, associated 
terminology 

• Search backwards, block generators, more navigation 
shortcuts, more drad-and-drop, and an even more enhanced 
trace log 

• Now Includes Scripffiase; stores your data and media elements 
and share them between scripts all with a special new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable 
applicaton 

• Scripter is the natural companion to AppleScript for users at all 
levels of proficiency. Don't write scripts without it! 

(SSCflIPTER) Our Price $199 



DynaMorph 1.5 

by Morph 

DynaMorph is the only cross-platform, server-side scripting language. 
Easily build and maintain dynamic websites and web-based 
applications. Access external databases, separate the format of a 
website from its content, conduct e-commerce transactions and 
more. DynaMorph makes sites and applications completely portable. 
(SDYNA) Our Price $399 





iDUCT! 

FaceSpan v3.0 

by Digital Technology International 
FaceSpan is a cutting edge interface 
design and rapid application development' 

(RAD) tool which gives you Vie power to 
build and customize Macintosh 
applications quickly and easily. 

• Acts as your front end for AppleScript or any other OSA (Open 
Scripting Architecture) language. 

• Allows you to automate often-repeated tasks, customize and 
integrate existing applications, build new applications and 
personalize your computing environment. 

• NEW! Allows you to create interfaces and applications that 
conform to the Mac OS 8 look and feel. 

• NEW! Supported display objects now include tab panels, 
disclosure triangles, bevel buttons and more. 

• NEW! FaceSpan run-time now launches up to bX taster. 

• Includes an unlimited, royalty-free distribution license for the 
interfaces and applications you create. 

(SFACESPAN) Our Price $149 


Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
/VppleScript! 

• Advanced debugging environment offera 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphical view of objects 
provided by scriptable applications 

• Includes Late Night Softwae Scripting Additions - a collection of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDEBUG) Our Price $129 


Q S(3i|1lOibugger 


WindowScript 

by Royal Software, Inc. 

WindowScript is the ultimate tool for designing Macintosh user 
interfaces using HyperCard. Design Real "Macintosh" user- 
interfaces right inside HyperCard. Until now you either created 
HyperCard slacks or Macintosh applications. With WindowScript you 
can literally bring the look and feel of a real Macintosh user- 
interface to HyperCard. If you’re a HyperCard developer, interface 
designer, application developer, program manager or tester 
searching for a prototyping tool, WindowScript is perfect for the job. 
(SWSCRIPT) Our Price $149 



Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

PreFab Player SPLAYER $95.00 
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NewtCard 

by NS BASIC Corporation 

NewtCard lets you put text, 
drawings, pictures and sound 
into a stack of smart cards 
on your Newton. Add buttons 
to navigate, fields to collect 
data, and scripts to bring 
your project alive with the tap 
of a pen! 

• Create business solutions, 
education courseware, inter* 
active presentations and more in an easy to use environment. 

• Enter text, numbers dates and times easily. 

• Create your own drawings or copy drawings and text from 
NewlWorks 

• Navigate to other cards, stacks or applications by clicking 
buttons you create. 

• Add scripts to your stacks in easy to use BASIC! 


(SNEWT) Our Price $99 



renowned rapid panoramic editor for QuickTime VR. Nodester 
generates interactive QTVR panoramic movies which iook out 
from a center or nodal point, allowing the viewer to experience 
the effect of a full 360 degree panorama. 

• Hot spot editor 

• Built- in image editor 

• Photoshop Acquire Module that supports all devices including 
film cameras, {through scanners or photo CDs), digital 
cameras, video cameras and digital video cameras. 

• Small memory footprint 

• Clean user-friendly interface 

• Plug-In architecture 

• Export both QuickTime VR 1.0 and 2.0 

System Requirements: Runs on Power PC only; requires 
allocation of 8 mb real RAM. 

(SNODE) Our Price $169 



ExposurePro 

by The Beale Street Group, Inc. 

ExposurePro allows you to, at the 
touch of a key (user-defined, of 
course), freeze the screen, select a 
portion with the powerful selection 
toots, and save the image to a TIFF, 
GIF, PNG. JPEG. PICT, or PICT clipping 
file. You can also save to the 
Clipboard, Scrapbook, or even send it 
directly to your printer, 

The power of ExposurePro lies not only in its screen capture 
capablities, but also in the vast array of editing tools: painting 
tools, drawing tools, all with customizable features rivaling a full¬ 
blown Image editing program. Convert to a different bit depth. 
Dither. The text tool might make you trash Illustrator! 

(SEPRO) Our Price $119 




'I 

WIdgetizer 

By Panimation 


Widgetizer is Panimation's 

WJ 27/7 

peerless rapid object editor for 


QuickTime VR. Widgetizer 
generates interactive QTVR 


object movies which look in at a center point or plane, simulating 
the effect of holding an object in the hand and turning it around to 
see all sides, top and bottom. 

• Definable hot spots 

• Custom backgrounds 

• Frame-based animation 

• Sound integration 

• Small memory footprint 

• Clean user-friendly interface 

• Piug-in architecture 

• Exports both QuickTime VR 1.0 and 2.0 

• Photoshop Acquire Module that supports all devices including 
film cameras, (through scanners or photo CDs), digital cameras, 
video cameras and digital video cameras. 

• Supports device (mechanism) software controlled QTVR object 
rigs 

• Expensive software controlled mechanisms are not required. 
System Requirements: Runs on 68K or Power PC; requires 
allocation of 8 mb real RAM. 

(SWID6) Our Price $169 


Media Cleaner Pro 

by Terran Interactive 

Use Media Cleaner Pro 2.0 to optimize and 
compress video (or CD-ROM, kiosk, or the 
Internet. Media Cleaner Pro automates your 
work flow allowing you to get the highest 
quality video, faster and easier than any 
other program on the market. 

• includes Adobe Premiere Export module 


• Optimal palette generation. Drag-and-drop 
batch processing 

• RealMedia, VOOLive and improved 
QuickTime support 

• Dynamic Preview Wfindow, the Media 
Wizard, multiprocessor support and more! 

System Requirements: 

68040 Mac or better (PowerPC strongly 
recommended, req'd for RealMedia), 


QuickTime 2.0 or later (2.5 strongly 
recommended) 

8 Mb application RAM, MacOS 7.0.1 (7.5 or 
later recommended) 

SoundManager 3.2, CD-ROM Drive 
(SMCP) Our Price $359 
Registered owners of Movie Cleaner Pro 1.3 
or earlier can upgrade 
(SMCPUP) Our Price $129 
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15 





































KAIDAN 

Digital Imaging Technology 

QuickTime VR Authoring Studio is Now Avaiiable for only $299 
when you purchase selected Kaidan products. 





QuickPan Magnum 

by Kaidan 


Get the QTVRAS for only $299 when you purchase the KiWi+, QuickPan Magnum or Magellan QC. This is a 
the stanciard retail price. Sorry, upgrades from the original VR Suite are not available. 

(HQTKB) Our Price $299 

Available only with Kaidan products KiWi+, QuickPan Magnum and Magellan QC, 


The QuickPan Magnum Series 
consists of two models, the QPX- 
1 and QPX-2, Featured on both 
models is the new QPU-2 camera 
bracket. Based on the highly 
successful KiWi, it provides a 
sturdy, coliapsible system for 
the mounting and adjusting of 
a wide variety of cameras and 
camcorders. The new base designs 
used on the Magnums are a refinement 
of our earlier bases, with the QPX-1 having a fixed base and the 
QPX-2 having a new low-profile micro-tilt adjustment stage. The 
easily adjustable click-stops will let you capture a panorama in a 
few seconds. The DPLJ-2 has two accessories, a Landscape 
Bracket for positioning the camera in the landscape orientation 
(QPLB-1) and a Counterweighting Kit (QPCW-1) used to balance 
large cameras or camcorders, such as the Sony VX-1000, that 
have a center of mass well behind the pivot axis. 

QuickPan Magnum-I (HQPMAGI) Our Price $499 
QuickPan Magnum-2 (HQPMAG2) Our Price $549 


savings of approximately $95 off 


Magellan QC 

by Kaidan 

The Magellan QC is capable of handling 
objects as large as six inches in diameter 
and five pounds in weight, the Magellan 
QC is the perfect choice for those 
needing to capture small objects at a 
reasonable price. Real-world objects can 
be turned into 3-D virtual reality movies 
using the QuickTime VR Authoring 
Studio and the Magellan QC. 

The Magellan QC leverages the 
capabilities of the Connectix'" Color 
QuickCam™ digital camera for QTVR 
object capture. The Color QuickCam’s close 
focusing capability (one inch to infinity), 640 x 480 resolution, serial 
interface (no video card required), 24-bit color support, convenient 
size and low cost make it an ideal camera for many simple QTVR 
object movies. Using the Magellan QC is easy, Simply locate the 
object on top of the adjustable pedestal, perhaps with a small piece 
of double-sticky tape, and then adjust the arms and pedestal so 
that the center of the object is centered in line with the camera and 
the rotation axis of the swingarm, 


QuickPan Magnum Accessories 


(HMAGQC) Our Price $299 


Counterweighting Kit 


Magellan Accessories 


Magellan QC Pedestal Set 

Two extra pedestal tube assemblies, one 2.5" and another 6" 
long. These extra pedestal tubes are used to support objects of 
varying sizes on the Magellan QC. 

(HMAGPED) Our Price $39 

Magellan QC Detent Wheels 

A pair of optional detent wheels (Color = Gold) with 8 (45 
deg), 12 (30 deg), 14 (25.7 deg), 16 (22.5 deg) and 18 (20 
deg) settings. The standard wheels (Color = Aqua) provide 10, 
15,20, 24 and 36 positions. 

(HMDWHLS) Our Price $74 


The Counterweighting Kit includes a weight and adjustable arm 
that is used to offset the weight of large, heavy cameras and 
camcorders, 

(HWHTKD Our Price $129 

Detent Wheel 

Detent Wheel (5-inch) (Color = Purple); 10,14,18,24 and 30 
Position (QPDD-2) 

(HQDWHLS) Our Price $49 

QuickTilt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2, that mounts between your panhead or camera 
and your tripod. It makes the leveling process quick and easy. 
Particularly useful when you plan to shoot a number of 
QTVRA/R nodes in a short period of time. 

(HQTLVLR) 0urPrice$149 
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E-mail; orders@devdepot.com 
U.S./Canada: 800-MACDEV-1 (800-622-3381) 
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Please fill out as completely as possible to avoid delays in processing your order. 
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Fax 


n Cash n Check/Money Order 

n VISA □ MasterCard □ American Express Expiration Date 


Card * 

Signature 
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If you are ordering a subscription to MacTech'* Magazine, are 
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^Magazine subscriptions are non-taxable 
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KiWi 

by Kaidan 

The KIWi'“ 

Is the most 
affordable VR/QTVR 
panhead, bringing digital 
photographic panoramas 
to an even wider audience. 

It's the perfect companion to 
programs such as QuickTime VR Authoring Studio, PhotoVIsta and 
Nodester, providing a complete solution for anyone interested in 
adding VR panos to their websites and multimedia applications. 

The K\W\™ consists of two intersecting black anodized aluminum 
struts that adjust and lock to accommodate a wide range of 
cameras, such as the Apple QuickTake 100/150/200, Kodak 
DC50/120, APS film cameras and 35mm SLRs equipped with wide- 
angle lenses. KiWF'^ attaches to any standard tripod and camera 
equipped with a standard 1/4-20 mounting thread. 


(HKIWI) Our Price $99 




KiWi+ 

by Kaidan 


The KiWi-i- adds a compact, yet 
durable click-stop mechanism and the 
same twin-axis bubble level found on the top-of-the-line QuickPan 
Magnum Series heads. The twin-axis bubble level (recommended 
by Apple and VR professionals) provides a clear indication of level, 
even when the unit is slightly above eye level. The click-stop 
mechanism uses easily replaceable detent discs, which are 
available in a number of positions (8,12,16,18, 20). The KiWi-r 
ships with one disc of your choice and extra discs are available 
separately or as a set. The click-stops speed the process of 
shooting a panorama by eliminating the need for the photographer 
to look at the unit in order to visually align the index increment. 


KiWi + Ships with detent disc of your choice 


KiWi-f- with detent dia: size 8 
KiWi+ with detent disc size 12 
KiWi-h with detent disc size 16 
KiWi-t- with detent disc size 18 
WWl-r with detent disc size 20 


(KIWIP8) Our Price $249 
^IWIP12) Our Price $249 
(KIWIP16) Our Price $249 
0<IWIP18) Our Price $249 
(KIWIP20) Our Price $249 


KIWI and KiWi+ Accessories 


QuickTIlt Leveler 

A leveling stage, similar to the one found on our QuickPan 
Magnum QPX-2, that mounts between your KiWi or KiWi-h and 
your tripod, It makes the leveling process quick and easy. 
Particularty useful when you plan to shoot a number of QTVR/VR 
nodes in a short period of time. 

(HQTLVLR) 0urPrice$149 

KiWi-to-KiWi+ Upgrade 

Includes the necessary parts required to turn your i^Wi into a 
WWi-H — adding click-stops and the twin-axis bubble level. Comes 
with a detent disc of your choice (8,12,16,18 or 20 positions). 
(HKIWIUP) Our Price $199 

KiWi+ Detent Discs 

KiWi-i- Detent Discs are available singly or in a set of four. In both 
cases you get to choose whichever discs you need. 

(HDTDISC) Our Price $24.95 each 

(HDTDISC4) Our Price ^9 set of four 

Choices include: 8,12,16 ,18, or 20 position detent disc 


Landscape Bracket 

The Landscape Bracket is a right angle bracket that allows you to 
mount the KiWi or KiWi-i- upright camera bracket in a horizontal 
orientation. This bracket is primarily used for cameras that have a 
limited field of view and you need to limit tie number of shots, 
(HLDBRAC) Our Price $42 

Flash Hotshoe Level 

A dud-axis bubble level that slides into your camera’s hotshoe. it’s a 
usekjl too! to help level the camera on the upright camera bracket. 
(HFLASH) Our Price $39 

Offset Spacer 

The Offset Spacer is a circular spacer that may be required for 
very narrow cameras (i.e. certain Ricoh digital cameras) in order 
to position the center of the lens over the pivot axis, 

(HOFFSPAC) Our Price $24.95 
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Be Studio 

by BeatWare 

Developed specifically for the 
BeOS, Be Studio is the first 
: graphics application to offer 
full multithreading for 
unbelievable responsiveness 
and untjeatable speed. Be 
Studio includes Paint for 
editing photos or creating 
original artwork and Draw, a 
. vector-based tool for 

drawing crisp designs and prints. Be Studio offers the BeOS 
I developer the ability to: 
j • Design application icons quickly and easily 
. • Edit and export images easily to the World Wide Web 

• Manipulate several images at once without degrading performance 

1 • View updates from a variety of perspectives simultaneously 

• Import and Export images as GIF, JPEG, PNG, TIFF, and PNM flies 

• Plug-in third party tools and filters 

;[ Be Studio requires the BeOS, 16 MB of FtAM (32 recommended), 
SMB available hard disk space and a 256-coior display adapter. 

I Price includes all major and minor upgrades through version 2.0 via 
I: electronic distribution. 

I (SBESTUD) Our Price $99 


’ webAlias 1.0 

“I by Lakewood Software 

webAlias 1.0 is an 
integrated image map 
editor and anti-aliasing 
text tool for web and 
graphic designers. Use 
webAlias to create 
complete web sites, 
single web pages, and graphic content for multimedia and web 
design projects. webAlias integrates support for line, shape, free 
form, field and button objects. webAlias’ anti-aliasing features 
include support for embedded pictures and gradients in text, as well 
as muftipie shadow and highlight effects. 

(SWEBALS) Our Price $129 




Music li^cks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music 
CD-ROM. The clips include musical 
introductions, fanfares, background music, 
and more. This collection offers you 100 
music clips stored in .WAV format for 
Windows, SoundEdit & AIFF formats for Macintosh and as Audio 
tracks for audio CS players. All of the music clips are completely 
license and royalty-free!! Mac System requirements: Mac Pius or 
greater, CD-ROM drive. PC system requirements: Windows 3.1 or 
later, Sound Blaster compatible board, CD-ROM drive. 

(SMT) Our Price $24.95 




MultiWare 

Multimedia Collection 

by BeachWare, Inc. 

Introducing a new Audio multimedia music 
CD-ROM for the Macintosh. This disc is a 
cdiection of clips ideal for Desktop 
Presentations and other Multimedia 
applications. This incredible collection of license-tree media clips is 
bursting with 240■^ color pictures and backdrc^s (PICT), 200-h sound & 
music clips (SoundEdil), 140+ QuickTime movies, and a variety of 
multimedia tools for use with the Macintosh. 


(SMWMC) Our Price $24.95 


HyperGuide 1.0 

by Lakewood Software 

HyperGuide 1.0 Is a hybrid 
multimedia authoring tool and on¬ 
line documentation system for the 
Macintosh and World Wide Web, 

HyperGuide provides integrated 
searching, indexing and 
bookmarking features. Supported 
media elements include: rectangle 
and scrolling fields, lines and shape fills, mcst QuickTime-supported 
image formats, anti-aliased text and QuickTime VR movies. 
HyperGuide also includes an integrated screen capture utility and 
user-conflgurabie slide show mode, 

(SHYPGUD) Our Price $149 





Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT CODE OUR PRICE 

AudioTrack SAUDIOTRK $270.00 

Captivate 4,6: Essential Graphics Utilities SCAPTIV $79.00 

ClipVR SCLIPVR $89.00 

Media Cleaner Pro SMCPUP $359.00 

Screen Machine SSM $24.95 
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PowerSD 

by Techworks 

The power of an arcade on your 
PowerPC Based on award winning 
3Dfx VooDoo Graphics. The PowerGD 
works with your existing graphics 
card and muiti-sync monitor to provide you the absolute in 3D 
performance, instaii the PowerSD in your PowerPC (requires one 
available PCI slot in your system) and use the provided pass-through 
cable to turn your PowerPC into a Power Arcade system! 

PowerSO comes bundled with these awesome 3D enabled games: 

• Quake"; Episode 1 (8 ievel) by id Software 

• MechWarriOf^ 2 by Activision 

• VR Soccer" by VR Sports (Actua'“ for Europe) 

• Weekend Warrior” by Bungie 


(SPWR3D) Our Price $249 


Abuse 

by Bungie Software 

Abuse is 360 degrees of side-scrolling action. 
Run, jump, fall and fly in any direction - through 
industrial corridors, caverns and sewers, Destroy 
enemies in any direction witii grenade launchers, 
rocket launchers, napalm and nova spheres! Avoid 
deadly traps with jet packs and turbo boost! 

Key Features: 

• Point and Kill Interface. Move and Esrnihilate mutants in complete 360° freedom 

• Blast your way through floors, walls and ceilings in search of the ultimate 
power-up! 

• Abuse Is 360 degrees of side-scrolling action. Run, jump, fall and fly in 
any direction - through Industrial corridors, caverns and sewers 
(SABUSE) Our Price $51 



1000 Games for 
Macintosh 

by BeachWare, Inc. 

The best Macintosh game disc in the 
entire world, tills CD-ROM contains over 
one thousand great shareware and public domain programs. Baffle ugly 
aliens, blast apart mn-away asteroids, deal yourself that royal flush or 
solve that 3-D puzzle, this disc has it all! System requirements: Mac 
Plus or greater, CD-ROM drive, and 2 MS of available RAM (4 MB of 
RAM when running under System 7). 

(STGM) Our Price $24 



Myth The Fallen Lords 

by Bungie Software 

PC GAMES MASAaNE’S, Most Anticipated 
New Game Award 

The Fallen Lords is a fully 3D real-time strategy 
game of epic battle. A multimetric game, Myth: 
The Fallen Lords gives gamers unprecedented 
freedom to view their forces, orbiting around 
the heads of a formation or zooming in for a 
close-up on savage melee. Myth: The Fallen Lords includes maps 
designed for networking, and alternate networking scenarios like 
Assassin and King of the Hill. 

(SMYTH) Our Price $49 


Classic Arcade 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, redone 
vwtti ki'ller graphics and sounds! Walk through a ’ 
virtual arcade and test your game playing skills 
witii these exciting arcade classics. Ten games, 
including Moon Lander, Astro-Boing, Hyper 
Hockey, Ballistic Avenger, and more. System Requirements: Mac—Color 
Mac with 8 MB RAM, CD-ROM drive, PC 486 wth 8 MB RAM, Sound 
card, SuperVGA, CD-ROM drive, 

(SCLA) Our Price $24 , 

Marathon IHIogy Box Set 

by Bungie Software 

The Marathon Trilogy Box Set brings all three 
Marathon games together in one affordable package, 
with tons of extras thrown in. Besides Marathon, 

Marathon 2; Durandal and Marathon Infinity, you'll also 
receive a staggering 1200 maps, featuring never- 
released Bungie maps and the winners of the Infinity 
MapmaWng Contest, The Marathon Scrapiwok (a behind-the-scenes look at 
themaking of the Maratiion games), Marathon collectables like the Marathon 
3-sticker set, and to top it off, the award-winning game that laid the 
groundwork for Marathon: Bungle's breakthrough Pathways Into Darkness. 

The Marathon Trilogy Box Set is native to the Power Macintosh, utilizes the 
graphics acceleration of 630 and 6200 machines, is 8,16 and 24-bit color 
capable, and can be played with joystirfrs and game pads. The package 
requires a 68040 or higher Macintosh, CD-ROM drive, 8-bit color monitor ii 
(13" recommended), and System 7 or later. |:, 

(SMTBS) Our Price $65 ii 





IfZ/LlT*** Here are more products. For full product descriptions please see our Web 

site, or feel free to call, fax, or E-mail us. 


JR 

Horey product 

CODE 

OUR PRICE 


A Zillion Sounds 

SAZS 

$24.00 

1 

Casino! 

SCAS 

$24.00 


Night Sky Interactive 

SNSI 

$24.00 


Trivia Warehouse 2000 

STW2K 

$24.00 


Web site; http://www.devdepot.com • E-mail: orders@devdepot.com 
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metrowerks 


GeekWare" 

You live it, you breath it... you 
m i ght as wel I wear it! (XL on ly) 



Alien T-Shirt 

^LIEN) Our Price $9.95 

Arnold T-Shirt 

(ACWARNLD) Our Price $9.95 

Arnold Jr. T-Shirt 

(AARNOLDJR) Our Price $9.95 

Blood, Sweat & Code T-Shirt (SS} 

(ACWSBLOOD) Our Price $9.95 

Blood, Sweat & Code T-Shirt (LS) 

(ACWLBLOOD) Our Price $14.95 

CodeWarrior Baseball Cap - Black 

(ACWBHAT) Our Price $14.95 

CodeWarrior Sweatshirt - Black 

(ACWSWEAT) Our Price $29.95 

CodeWarrior Hawaii Fhre-O Shirt 

(ACWHAWAii) Our Price $9.95 

CodeWarrior Winter Hat 

(AWiNHAT) Our Price $14.95 

Bebugger Boxer Shorts 

(ADBOXER) Our Price $16.95 

Discover Programming T-Shirt 

(ADiSCPT) Our Price $9.95 




Podeum Sport 

by Rach, inc. 



Now you can have laptop stability, drop 
protection & mobility, If you're looking 
for an inexpensive, non-technical gift 
for a laptop owner - look no further. 

• Strap your laptop to your leg 

• Universal size - fits all laptops and 
all legs {13"-46") 

• Velcro Velcoins attach your laptop to the podeum 

• Podeum allows working angles up to 90 degrees 
Dropped laptops account for 41 % of all laptop fatalities 
Manufacturer's lifetime warranty. 

(APODSP) Our Price $39 



MacTech® Mouse Pad 

Slide on this! With an extra-large surface (11" by 10"} and 
a deluxe sleek plastic coating, you'll be zooming across 
your screen in no time at all. Speed limit not enforced I 
(AMTPAD) Our Price $8.95 
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for 

Programmers ^ Developers 

MacTbdr 

MAGAZINE 


MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with everything they 
need to Imow atxxit software development. Topics iike Rhapsody. Java, 
QuickTime. OPENSTEP, Ob]ective-C, C/C++, Object Oriented Technoiogies, 
product reviews and much more! 

Subscriptions: 

(MTYRDM) US/Domestic for 12 issues $47 

(MTYRCM) Canadian for 12 issues $59 

(MTYRFM) International for 12 issues $97 

Back Issues; each pius shipping (subject to avaiiability) $10 




MacTech® CD-ROM Volumes 1-12 

• inciudes /Apple’s issues 1 -29 (1990-1997) 

• Aimost 1600 articles from all 139 Issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• Improved hypertext, improved indices, and a new THINK Reference Viewer- 
for lightning quick access! 

• New hyperlinks between articies 

• 100+ MB of source code—use them in your applications, with no royalties! 

• Full version of THINK Reference^”—the original online guide to Inside Macintr^h, Vois. i-VI 

• 80MB of FrameVi/orks/SFA archives and the most complete set of Frameworks archives known 

• Sprxket™! MacTech’s tiny framework that complies quickiy and supports System 7.5 features 

• The best threads from the Macintosh programmer newsgroups pius thousands of notes, tips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

{SMTCD12) Vo!umes1-12 Our Price $129 
(SMTCD12U) Upgrade from any previous version Our Price $49 



Inside Macintosh: CD-ROM 

by Appie Computer, Inc. 

More than 25 volumes in elec^nic form. Includes: 
QuickDraw™ GX Library, Macintosh Human Interface 
Guideiines, PowerPC System Software, Macintosh Toolbox 
Essentials and More Macintosh Toolbox, QuickTime and 
QuickTime Components. Access over 16,000 pages of 
information with H^rertext linking and extensive cross 
referencing. 

(BIMCD) Our Price $89 



Order Totl<dree 
800-MACDEV4 

'IKI062M38II 


Web site: http://www.clevdepot.com • E-mail: 0rder5@devdep0t.com 
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Hev! Books! 




Pilirick (hjin * kwJ^FKi Lee 


The Jlii¥a‘ Class 
Second Fditioi% 2 


The Java Class Libraries, 
Second Edition, Volume 2 

by Chan Lee 

This book is intended as a reference rather 
than a tutorial. Its format is similar to a 
dictionary's in that it is designed to optimize 
the time it takes for you to look up 
information on a class or class member. The 


classes in this book are ordered alphabetically without regard to 
package name. This makes looking up a class as straightforward as 
looking up a word in a dictionary. Each class is described in its own 
chapter. Each chapter contains a picture of the class hierarchy, a 
class description, a class example, a member summary, and 
descriptions for every member in the class. 

(BJCLASS) Our Price $44 


» 


AppIeSh^ 
^ IP 


M [iwnilnilil Htaw 


AppleShare IP: 

This book is for administrators either using or 
planning to use Apple's new networking 
system. The book discusses choosing 
servers, configuration, access privileges, the 
AppleShare file server, print service, e-mail!, 
^ web services, Apple Search, MacDns and 
^ interfacing third party products. 

• Discusses choosing a server and the AppleShare file service 

• Cover AppleShare IP support for PCs 

• Addresses AppteSha'e IP e-mail, web and print services 

• Includes hands-on exercise and one CD-ROM for Macintosh with 
and AppleShare IP Administrator's Toolkit 

(BSHARIP) Our Price $35 


Interface Design: 

This book is a practical guide for 
designingsoftware with users in mind, it 
offers an on-the-job view of what it takes to 
create great products, offering practical tips 
and advice instead of forcing the reader to 
extrapolate from abstract psychological 
theory. Interface Design targets a wide range 
of design issues, from taming the incomprehensible interfaces of 
database systems and the internet, to using sound and animation 
effectively In multimedia. Throughout the book, the author offers 
techniques for controlling the growing complexity of computer 
software, and makes an impassioned case for intelligent design 
based on the real need of users. 

(BINTER) Our Price $31.00 


Interface 

Design 



Be Developer’s Guide 

by The Be Developement Team 

The Be Developer’s Guide is the official 
programmer’s reference manual for the 
BeOS, a revolutionary new operating system 
built around multimedia, threading, and 
multiprocessing. Essential reading for anyone 
who wants to design runnable applications 
for the BeOS, this book describes and explains how to use alt the 
development kits, providing multimedia developers access to the 
internals of the first new operating system in years. 

(BBEDEV) Our Price $45 



TheOpenGL Programming 
Guide 

by Mason Woo, Jackie Neider and Tom 
Davis 

• Coverage of the new features of OpenGL, 
Version 1.1, including all textudng changes, 
vertex anays, polygon offset, and R6BA 
logical operations 

• The incorporation of the OpenGL Utility Toolkit, GLUT, in all 
programming examples an overview of the OpenGL rendering 
pipeline and state machine 

• Enhanced coverage of polygon tessellation, quadric surfaces, pixel 
operations, and error handling 

• More performance tips 

• A greatly expanded index. 

(BOPGL) Our Price $39 


The Java FAQ 

by Jonni Kanerva 

Java FAQ provides an insider’s view of the 
Java™ technology by posing 
and answering the most important, frequently 
asked questions about the Java programming 
language, Java applets, and Java stand-alone 
applications. The Java FAQ is unique in that it 
draws from the tens of thousands of questions sent to 
<java@java.sun.com> and provides authoritative answers direct 
from the creators of the Java programming language at JavaSoft. 
(BJFAQ) Our Price $25.13 




Order Toll-free 
800-MA(DEV.1 


|li(10«2233S]| 
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APPLE ENTERPRISE SOFTWARE 


Getting Started With WebObjects 

by Apple Enterprise Software 

If you’re a first time user, start here to learn the basics of how to 
create and run WebObjects applications. 

(BGSWO) 0urPrice$14 


WebObjects Deveioper's Guide 

by Apple Enterprise Software 

A guide to building and understanding WebObjects applications. 
Takes a close look at the WebObjects scripting language. Additional 
sections explain the WebObjects architecture and tells you how to 
integrate your code into the request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Filled with 
example code. For all WebObjects programmers. 

(BWODG) Our Price $16 

D'OLE Deveioper’s Guide 


Object-Oriented 
Programming and Objective C 

by Apple Enterprise Software. 

An introduction to the principles of object-oriented programming in 
OPENSTEP and the official description of the Objective-C language. 
Objective-C is easy to learn and use because it adds very little 
syntax to the C programming language. It's dynamic nature allows 
you to accomplish things not possible in most other object-oriented 
languages. For any OPENSltP programmer. 

(BOOPOC) Our Price $24 


by Apple Enterprise Software 

Distributed OLE is available today, and this book shows you how to 
use it. Using real-world examples, the book steps you through the 
process of making your OPEIMSTEP objects available on Windows 
through OLE. 

(BDOLEDG) Our Price $22 


Working w/ Interface Builder (for eof) 

by Apple Enterprise Software 

A hands-on, award-winning book designed to help you get your job 
done with the updated Interface Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1.1. For any programmer 
using Interface Builder to design objects that truly work in 


NEXTSTEP. 

Discovering OPENSTEP, Mach (bwib) our Price $24 

by Apple Enterprise Software 


Introduces programmers to NeXT's OPENSTEP 4.0 Developer product 
by guiding them through the creation of three applications of 
increasing complexity. The tutorials demonstrate and explain 
programming techniques. Objective-C fundamentals, common APIs, 
and usage of the developement toots. Along the way they present 
summaries of important concepts and paradigms. The book also 
includes a chapter directing readers to programming resources, 
further information, and services such as training and support. An 
appendix offers a concise discussion ot object-oriented programming. 
(BDOSTEPM) Our Price $15 


Using EOF 2.1 W/ OPENSTEP (Mach & Windows) 

by Apple Enterprise Software 

Using Enterprise Objects Framework with OPENSTEP describes how 
to create an Enterprise Objects Framework application on 
OPENSTEP, It includes a tutorial and a chapter on creating a user 
interface for an OPENSTEP Enteiprise Objects Framework application. 
(BUEOFO) Our Price $14 

EOF Developer's Guide for EOF 2.1 (Mach (Windows) 

by Apple Enterprise Software 


Discovering OPENSTEP, Windows 

by Apple Enterprise Software 

Discovering OPENSTEP provides an introduction to OPENSTEP 
programming on Windows NT. It guides the reader through the 
creation of three applications of increasing complexity. Along the way, 
it explains concepts and illustrates aspects of Objective-C, OPENSTEP 
classes, the development environment, and programming techniques. 
A short appwidix offers a summary of object-oriented programming. 
(BDOSTEPW) 0urPrice$16 


The Enterprise Objects Framework Developer's Guide describes how 
to develop database applications using the Enterprise Objects 
Framework tools and classes, it includes an architectural overview of 
the product and descriptions of programming tips and techniques. 
An appendix offers a summary of Entity-Relationship Modeling. 
(BEOFDG) Our Price $24 

EOF Developer's Guide for EOF 2.0 (8EOFDG20} Our Price $24 
EOF Developer’s Guide for EOF 1 .x (BEOFDGtX) Our Price $24 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Rhapsody Developer’s 
Guide 

by Jesse Feiler 

Covers the basic architectural principles 
of Rhapsody; the Mach microkemei, 
object-oriented programming, and the 
elements of a modem OS such as 
preemptive multitasking, protected 
memory, and symmetric multiprocessing. 
Also shows ways of getting to this new environment—Objective C, 
conversion tools, and the integration of Java—to develop Rhapsody 
products. Paperback. 450 pages. 

(BRDG) Our Price $35 


Building An Extranet 
Connect Your intranet With 
Vendors And Customers 

by Julie Bort and Bradley Felix 

Building an Extranet will help companies use 
their Intranet capabilities to supply information 
to selected customers and vendors through a 
secure Extranet. This book provides complete information and working 
details lor building the netwoi1< behind Intranets and Extranets, 
designing the applications, and getting everyltiing up and running. 
(BBLDEXTl Our Price $26.99 




Debugging Macintosh 





Its OTH MIR 
JIM M 


Software 
with MacsBug 

by Konstantin Othmer and 
Jim Staraus 

MacsBug, from Apple Computer, Inc., 
is the leading debugging software 
program for the Macintosh. This 
book/disk package is an all-in-one kit 
for using MacsBug. Chapter 1 introduces MacsBug and describes 
the contents ot the rest of the book. Chapter 2 describes how to 
install MacsBug and enough low level details about the Macintosh 
so »iat you can use MacsBug. Includes MacsBug 6.2 on disk. 
(BDMSWM) Our Price $31 


Increasing Hits and Selling 
More on your Web Site 

by Greg Helmstetter 

Written especially for entrepreneurs, 
corporate marketing managers, small 
business owners, and consultants, this 
valuable guide gives you rare tips and tricks 
you need to know to make your site a commercial success. 
(BIHSMWS) Our Price $22.45 



I Check out our Web site! 

I • Full product descriptions • Hundrads of more products 

I http://www.devdepot.com 


Effective C++, 

Second Edition: 

50 Specific Ways to improve Your 
Programs and Designs 
by Scott Meyers 

Effective C-I-+. 2nd Edition includes; Expert 
guidance on object-oriented design, class 
design, and the proper use of inheritance 

• An examination of the standard C-n- library, including how the 
Standard Template Library and classes tike string and vector affect 
the structure of well-vwitten programs 

• Discussions of late-breaking language features like in-class 
constant initializations, namespaces, and member templates 

• Wisdom usually possessed by only the most experienced 
developers 

• Effective C-t-r continues to be essential reading for every 
developer working with C-i-f. 

(BEFFC) Our Price $34 



The Official BBEdit Book 

by Bob LeVitus and Natanya Pitts 

The Official BBEdit Book makes it easy for 
today's Webmasters to speed their own 
interactive development projects using this 
powerful editing environment. Bare Bones 
incorporates features like floating palettes. 
HTML support, and syntax coioring to 
enhance an already extensive feature set, making BBEdit a leading 
Web authoring tool. Super-last text processing, easy scripting, wide 
extensibility, strong GREP-style search-and-replace capabilities, and 
support for 13 languages make it easy to see why so many Web 
developers use BBEdit ^ their primary authoring tool, 

(BOFBB) Our Price $35 



Tiie Official 
BBEdit 
Bookjs- 



Practical Object- 
Driented Development 
in C++ and Java 

by Cay S. Horstmann 


This book offers advice on real-world 
ways to use these powerful 
programming languages and 
techniques. Using the Unified Modeling 
Language (UML) methodology, expert 
Cay S. Hwstmann gives you clear, concise explanations of object- 
oriented design, C-m-, and Java In a way that makes these potentially 
daunting operations more accessible than they’ve ever been before. 
(BPOOD) Our Price $31 


24 l-80aMACDEV-l • Outside U.S. & Canada: 805494-9797 • Fax: 805-494-9798 



















DeBabelizer 

by Lise Despres and Paul Vacbier 

DeBabelizer; The Authorized Edition is the 
otticial guide for Web designers, 
multimedia creators, artists and production 
specialists who want to take advantage of 
this powerful tool. 

• Create graphics and images for the Web that download fast and 
look amazing 

• Optimize graphics for CD-ROM, video, and animation 

• Optimize and manage colors using the SuperPalette(rM) 

• Discover DeBabelizer tips and advice from industry experts 

• Master basic manipulation techniques, including rotation, scaling, 
cropping, and text overlay 

• Explore key production techniques in all areas of graphics 
processing 

(BDEBTAE) Our Price $40 



JavaScript 
& Netscape Wizardry 

by Dan Shafer 

The perfect book to 
show you how to turn 
Netscape into your own 
personal, customized 
operating system. 

Provides the inside tips and 
techniques for making your Web pages much more attractive. 
Shows you how to use all of the key features of the JavaScript 
language, including objects, methods, properties, events, and 
much more. Includes CD-ROM with numerous interactive scnpte 
written in JavaScript you can add to your Web pages today. A 
complete set of the best Java applets. Useful plug-ins designed to 
supercharge Netscape and resources to help JavaScript 
programmers. 

(BJNWIZ) Our Price $31 



NETSCAPE 

WIZARDRY 





Designing 3D 
Graphics 

by Josh White 

In this powerful book/CD-ROM package, 
top computer graphics artist Josh White 
tells you everything you need to know to 
create sophisticated real-time 3D 
graphics tor computer games and 
virtual reality. This book contains the in- 
depth knowledge of software tools and hands-on modeling 
techniques that Josh White has learned while creating artwork tor 
over 20 commercial games, including Descent, Zone Raiders, Locus. 
Legoland. and others. 


(BD3DG) Our Price $35 



Linux Configuration 
& Installation, 

3ni Edition 



by Patrick Volkering, Kevin Reichard, and 
Eric F. Johnson 

Linux, the leading UNIX variant, has garnered 
loads of attention within the UNIX community. 
The amazing thing about Linux is that you 
don't need a workstation to run it. Linux Configuration & Installation, 
Second Edition lets you run Linux today. Program with Linux using C. 
C-H-, Perl, and Tcl/Tk. The 2 CD-ROM pack offers one of the most 
popular Linux distributions, Slackware 96, and comes directly from 
Patrick Volkering, the creator of Slackware. 

(BLCI2) Our Price $35 
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Symantec Visual Cafe 
Sourcebook 

by Cary A. Jardin and Pam Dixon 

Symantec Visual Cafe, the first visual Java 
development tool that gives programmers a 
sophisticated set of tools. This book teaches 
programmers how to use Symantec Visual 
Cafe to create Java applets. It provides a thorough introduction to 
the language and gives advanced Java programmers Information on 
how to use Visual Cafe to create their own Java development tools. 


(BSYMSOUR) Our Price $35 


HTML Sourcebook, 3nl 
Edition 

by Ian S. Graham 

Critics everywhere agree, HTML Sourcebook 
is the best guide to HTML for Web 
professionals. That's because no other book 
makes it so easy tor you to quickly master 
all the commands, tools, and expert 
techniques you need to create cutting-edge Web page documents. 
Completely revised and expanded by nearly 50 percent, this new 
third edition of the best-selling guide to HTML gives you the 
complete lowdown on all the changes and enhancements to the 
HTML. HTTP, and URL standards. 

(BHTMLS) Our Price $26.95 


Teach Yourself J 
Macintosh in 21 

by Laura Lemay and Charles L. Perkins 
with Timothy Webster 

Add interactivity and muitimedia to Web pages! 

A step-by-step guide to make your Website 
come alive. Learn the basics of programming 
Java applets and the concepts behind the Java language. Includes CD- 
ROM witti a limited version of Roaster, the first commerciai, integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 
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Programmer’s Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials, 
by Addison-Wesley Publishing 

Get quick access to reference pages for over 
4,000 Toolbox calls in your system software 
from their development environment. Essential 
information for Macintosh software developers. Hypertext links allow 
programmers to view related topics easily. The ultimate electronic 
reference tool for Macintosh programmers. 

(STBASST) Our Price $89 



Web Publisher’s Design 
Guide for Macintosh, 
2nd Edition 

by Mary Jo Fahey 

This is the only book that takes you 
step-by-step through real projects 
designed by talented new media artists. 
Internet design experts share their 
design secrets and art files (look for art 
files on the companion CD-ROM by artist’s last name), This expanded 
new edition includes Photoshop, Illustrator and DeBabelizer tricks 
from the first edition plus countless new ways to liven up your Web 
pages with 3D graphics, sound, movies, and much more, 

(BWPDG2) Our Price $35 
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design 
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HTML For The World 
Wide Web, 2nd Edition 

by Elizabeth Castro 

Teach yourself Hypertext Markup 
Language the quick and easy way! This 
Visual QuickStart Guide uses pictures 
rather than lengthy explanations. You’ll 
be up and running in no time. If you 
need to learn HTML fast - this is book 
is for you. 

(BHTMLW2) Our Price $16.15 


Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 


The complete resource for creating 
Shockwave movies on the Web. This 
hands-on reference makes it easy to 
create Shockwave movies and put 
them on the Web. Expert rips from the 
creators of Macromedia's first 
Shockwave movies, together with detailed examples and instruction, 
provide everything you need to get started. Includes CD-ROM. 
(BMSFD) Our Price $27 


Getting Hits-The 
Definitive Guide To 
Promoting Your Website 

by Don Sellers 

Getting Hits explains in easy-to- 
understand language the underlying 
concepts behind the art of Web site 
promotion. Just a few of the topics 
you’ll learn include: using search 
engines with URL’s; finding related Internet groups or lists; 
understanding the nuances of click throughs and ad rates: and 
distributing press releases to key Internet contacts. With this book, 
you’ll go beyond the conceptual and actually follow real-world tested 
promotional campaign strategies. Bring the world to your Web site! 
(BGHITS) Our Price $17.95 




Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembly Language 

by Gary Kacmarcik 

Take full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

(BOPTPPC) Our Price $35 
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JavaScript For The 
World Wide Web 

by Ted Gesing and 
Jeremy Schneider 


This book takes an easy, visual 
approach to leaching JavaScript, 
where pictures guide you through the 
software and show you what to do. 
Works like a reference book, you look 
up what you need and then get straight 
to work. Mo long winding passages, concise, straightforward 
commenfary explains what you need to know. 

(BJlWWWfl Our Price $16.15 
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WebMaster in a Nutshell, Deluxe Edition 


by O'Reilly & Associates, Inc. 

Cross-platform, completely portable, and lightning fast, 
the CD-ROM is an invaluable addition to the 
webmaster’s toolbox. The CD-ROM contains the Web 
Developer's Library—tfie full text of the latest editions of five 
popular O'Reilly titles: "HTML: The Definitive Guide, 2nd Edition"; 
"JavaScript; The Definitive Guide. 2nd Edition"; "CGI Programming 
on the World Wide Web”; "Programming Perl, 2nd Edition"; and 
“WebMaster in a Nutshell." The Deluxe Edition also includes a 
printed copy of "WebMaster in a Nutshell." the all-inclusive quick 
reference that belongs next to every webmaster's terminal. Includes 
CD-ROM & 356 page book. 



Requirements: The CO-ROM is readable on all platforms, but requires 
a web browser that supports HTML 3.2, Java, and JavaScript. 
(BWMNUTD) Our Price $62 
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CodeWarrior Software 
Development Using PowerPlant 

by Jan L. Harrington 



C++ programmers will learn to develop object-oriented software 
applications for the Mac and Power Mac using the PowerPlant 
environment and the classes that support it. Covers CodeWanior 8. 
Included CD-ROM contains source code tor all the programming 
examples in the book and Metrowerks CodeWarrior Lite. 

(BCWSWDEV) Our Price $31 





JavaScript 1.1 
Developer’s Guide 

by Arman Danesh and Wes Tatters 

Written by developers for 
developers. An advanced 
guide to creating 
professional Web 
applications with 

JavaScript 1.1 as deployed in Netscape 
Navigator 3.0, Microsoft Internet Explorer 3.0, and LiveWire. Includes 
CD-ROM with Sun's Java Developer’s Kit. JavaScript and HTML 
Editors for Windows and Macintosh, 20 contributed ready-to-ain 
JavaScripts and JavaScript examples from the book. 

(BJSDG) Our Price $44 
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Web Security Sourcebook 

by Aviel D. Rubin, Daniel Geer and Marcus 
J. Ranum 

Technical tools and techniques for 
building secure web sites and 
applications 

This book shows web masters, web 
managers, and web designers the hands on 
programming techniques necessary to build secure web sites. 
Readers will learn how to secure the server, use firewalls and 
cryptography, write secure Java applets and CGI scripts and more. 
Companion Web Site includes source code examples plus updates 
on the latest security threats and techniques. 

(BWEBSER) Our Price $26.99 

Wireless For ^ 

The Newton iSHl 

by Julie McKeehan and Neil Rhodes 

A book that picks up where 
Programming for the Newton left off, 
teaching the reader how to develop 
Newton software on the Macintosh. The 
enclosed floppy disk provides a sample 
application, as welt as a fully functional 
demonstration version of Newton Toolkit, 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment braining with sample code 

• Includes disk with sample source code for a Nevi/ton application, 
as well as demonstration NTK - the complete development 
environment for the Newton 

(BWIRELESS) Our Price $31 
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Check out our Web site! 

• Full product descriptions • Hundreds ot more products 

http;//www.devdepot.coin 


C++ Programming 
with CodeWarrior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Learn 
object-oriented programming techniques 
using C++ as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-furjction Metrowerks CodeWarrior. 

(BCPPCW) Our Price $33 







Learn C on The 
Macintosh, Second 
Edition 

by Dave Mark 

New revised edition! Easy-to-understand - 

_ everything you need to start programming. 

Updated and enhanced exercises that lead you 
step by step. You'll learn function, variables, point datatypes, data 
structures, file input and output and more! Includes CO-ROM with 
Metrowerte CodeWarrior™ Lite. 

(BLEARNC2) Our Price $33 


The Way Computer 
Graphics Works 

by Olin Lathrop 

A complete guide to mastering 
computer graphic basics. It is written 
in a frank, down-to-earth style 
covering everything from how 
computer graphics are different from 
fine art and photographs, to modeling, 
pixels, and the principles of animation. 
All of this is done without resorting to mind-numbing equations and 
impenetrable technical jargon. 

(BWCGW) Our Price $29.65 
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Inside PowerPlant 

by Metrowerks 

Create PowerPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor. Full descriptions of major PowerPlant classes 
and resources. Included are the PowerPlant Constructor Manual, 
including View, TextTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant. 
(BINSPP) Our Price $34 
SEE RELATED CATEGORY: Dev. Environment 
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AppleScript Language Guide 

by Apple Computer, Inc. 

A complete reference for anyone using AppleScripf to modify existing scripts or to write 
new ones. Contains useful information for programmers who are working on scriptable 
applications or complex scripts. Features detailed definitions of AppleScript terminology 
and syntax in the following categories: Value classes, commands, objects and 
references to objects, expressions, control statements, handlers, and script objects. 
Includes many sample scripts, discusses advanced topics such as writing command 
handlers for script applications, the scope of script variables and properties declared at 
different levels in a script, and inheritance and delegation among script objects. 

(BALG) Our Price $26.95 
SEE RELATED CATEGORY: Scripting 
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Special Edition 
Using CGI, 

2nd Edition 

by Jeffry Dwight, Michael Erwin 
and Robert Niles 

This complete reference provides 
professional Web developers and advanced 
personal users with the latest intonmation 

on using CGI (Common Gateway Interface) to interact with databases. 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific tips, 
tricks, and traps 

• CD ROM is loaded with the HTML and CGI sample code from 
the book 

• Includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUCGI) Our Price $44 
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AppleScript 
Applications: 

Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Liz O'Hara 
Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that makes AppleScript applications truly 
"Mac-Like*. Uses a step-by-step approach 
to demonstrate techniques for building 
applications through illustrations and 
samples. Provides Graphical User Interface 
(GUI) design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1.1, a demonstratitHis version of 
FaceSpan 2.t, source code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section (ki debugging AppleScript 
applications using FaceSpan. 

(BAPSCAP) Our Price $31 

Java in a Nutshell, 2nd 
Edition 

by David Flanagan 

A detailed overview of all of hie new features 
in Java 1.1, both on a package-by-package 
basis and in terms of overall tunctionalj^. A 
comprehensive tutorial on “inner classes" 
that explains how to use all of the new types 
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JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 

Allows non-programmers to take 
advantage of the power of 
Netscape Navigator. Expand the 
capabilities of your Web page, without 
having to understand C or C++. CD-ROM 
contains “Wiziets” that allows you to easily 


create your own JavaScripts. Takes you step-by-step through 
programming cross-platform JavaScripts. Details how to create 
JavaScripts for JavaScript-aware Web browsers. 
(BJAVASCRPTJ) Our Price $40 


of inner classes: static member classes, member classes, local 
classes, and anonymous classes. Practical, real-world example 
programs that demonstrate the new features in Java 1.1, including 
object serialization, the new AWT event handling model, 
internationalization, and a sample Java Bean. 

(BJNUT2) Our Price $17.95 

AppleScript Finder Guide, English Dialect 

by Apple Computer, Inc. 

Provides definitions tor Finder object classes and commands. Write, 
record, or run scripts that trigger the same desktop actions that you 
trigger using the keyboard and mouse. 

(BAFG) Our Price $17.95 

SEE RELATED CATEGORY: Scripting 

Inside CodeWarrior Professional 

by Metrowerks 

Includes CodeWarrior IDE User's Guide. This is the printed version of the 
documentation provided on the CO. Covers CodeWarrior Professional 
Release, the debugger and assxiated tools. 

(BINSCWP) Our Price $34 

SEE RELATED CATEGORY: Dev. Environment 
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3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 3D graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extenaon to the 
Mac 0$ for Power Macintoshes. CD 
contains the complete QuickDraw 3D 
system itself and a complete database of the QuickDraw 3D API. 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages. 

(B3DGRAP) Our Price $35 






Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software’s color 
capabilities with step-by-step 
instructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
GX. Use the Pallette Manager to get the 
best colors on limited displays. Match 
colors between screens and input/output devices (scanners & 
printers). CD includes a complete reference information in both 
QuickView and Acrobat formats. Plus, a sample application 
cfemonstrating ColorSync programming techniques. 

(BADVCI) Our Price $33 


THcks of The 
Mac Game 
Programming Gurus 

by McComack, Ragnemalm, CelesUn, et al. 

For beginning to expert game 
programmers. Complete overview of all 
the necessary components of game 
programming on the Macintosh. Packed 
with valuable tools, utilities, sample code. CodeWarrior^*^ Lite and 
game demos. QuickDraw 3D and Power Mac optimization and inside 
info on how Glypha III was created. Hundreds of tried-and-true 
tricks, tips, and insider secrets from well-known Mac game 
programming e>q)erts. 

(BTRICKS) Our Price $45 


Black Art of Macintosh 
Game Programming 

by Kevin Tieskoetter 

Develop your own 3D games in 
C on the Mac. Includes CD writh 
project fifes for both Symantec 
C and Code W»rior. Create ' * ® 

freeform texture-mapped games and 
polygon graphics. Control dynamic source 
code—all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

(BBLACK) Our Price $35 
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The NEW BBEdit 4.5! 


It<Doesn*t Suck. 

still 


There has never been a 
better time to buy 
BBEdit. 

Upgrade from BBEdit Lite, 
Codewarrior, MPW, 

Symantec C++ or a number 
of other products for just $79. 

This offer is avaiJable direct 
from Bare Bones Software, Inc. 

To order, call us at (617) 778-3100 
or visit us online. 




<http://www.barebones.com/> 





Bare Bones Software, Inc. 

RO. Box 1048, Bedford, MA 0J730 • main 617-778^3100 • fax 617-778-3111 


BBEdtt Is a trademark of Bare Borxs Software, [nc. 'It Doesn't Suck' Is a registered trademark of Bare Bones Software. Inc. © 1997 Bare Bones Software, Inc. All rights rescr^^ed. 





























wvuvwvciviivr rruieasiVIICII Just out and 

ready for some serious-i industrial'Strength programming* This 
is the only Integrated Development Environment that ows 
yoU; to editi compile and debug Cn C++^ Java and Pascal program 
for multiple target processors and operating systems* lile're' 
still the codewriter'-s best friend and now we're better than 
ever.Here’swhy: — 


^portable project files — may be used interchangeably 
between HAC and Uindows platforms ’ “ - 

Xfile compare and merge — select two files to graphically 
view differences and merge changes 

Xbrowse across subprojects — source code.browser works 
across targets and subprojects 

You can co.unt on Codetlarrior Professional Release 2* Ue're 
powerful-! proven-! easy*to* handle and we've had all our shots 


CodeWarrior 

^ O. r A o V. 


metfowerl<s 
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